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About This Manual Thank you for choosing a ZAX in-circuit emulator! Your ZAX 

emulator is one of the most powerful and sophisticated micro- 
processor development tools in the industry— as you will soon 
discover. But for all the things your emulator can do, it's still 
very simple to use. In fact, you don't have to know a thing about 
ZAX emulators to use this manual. The information presented 
in this manual is structured for first-time users, so you'll be 
learning about emulation techniques and applications as well. 
If you're already familiar with the principles of emulation, you 
can use this manual to learn a few basic emulator skills, and 
then use the section on commands as a reference. 

What This Manual ■ How to identify the parts (controls, components and acces- 
WIII Show You series) of your emulator and what they do (Section 1). 

■ How to connect the emulator to your terminal, host compu- 
ter and target system (Section 1). 

■ How to find out more about special emulator controls and 
learn how to use them for your specific applications (Sec- 
tion 1). 

■ How to use the accessories that came with your emulator 
(Section 1). 

■ How to use each of the emulator commands (Section 2). 

■ How to learn more about how your emulator works by exam- 
ining the internal control modules (Section 3). 

■ How to write support software programs for communication 
between the emulator and a host computer (Section 4). 

How To Use This Manual There are really only two things you must know to use a ZAX 

emulator; the first is how to connect it to your present system, 
and the second is how to control the emulator's operation by 
using the commands. These two subjects are presented in the 
first two sections of this manual, and of these two, you'll be us- 
ing the section on "commands" particularly. 
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Emulator or ICD? 


So first, read Section 1 to learn about the various controls and 
components of your emulator. (Before you can operate your 
emulator, you’ll have to set certain switches and make some 
minor adjustments so that it performs correctly with your sys- 
tem.) Then, continue on to learn how to connect your emulator 
to other devices, such as a console terminal or a host com- 
puter, and your target system. 

Once your emulator is working properly, you can refer direct- 
ly to Section 2 to find out how to enter any of the emulator com- 
mands. Each command’s function is examined along with the 
format needed to use the command. Once you’re famihar with 
the command syntax, you can use the fold-out Command Ref- 
erence Guide located in the front of the manual. 

If you need a refresher course on emulation principles, turn to 
Appendix A. If you’re not sure how to apply the commands in 
an actual emulation session (we call it ’’debugging”), turn to 
Appendix B for a demonstration. Use Section 3 for a reference 
(it contains technical information that you may find useful later 
on). You can use Section 4 if you’re writing your own support 
software programs to interface your host computer to the 
emulator. 

Oh by the way, any time a word or phrase is used and you don’t 
understand its meaning, turn to the Glossary at the back of this 
manual. It contains definitions for a number of common 
engineering terms as well as many specialized microprogram- 
ming terms. 

One last thing— the official name of your emulator is the 
ICD-278 for Z80 aCD stands for IN-CIRCUIT DEBUGGER; 278 
is the model number). That’s quite a mouthful though, so to 
shorten things up we’ll use the initials ICD whenever we mean 
the IGD-278, in-circuit debugger, emulator, or in-circuit 
emulator. 

Now turn to Section 1 and get started. 
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With Your ICD 


ICD DESCRIPTION & OPERATION 


In Section 1 you'll learn about the different parts of your ICD, 
what they do, and how to use them. You'll also learn how to 
connect the ICD to your system (terminal, host computer, tar- 
get system), and find out about how to use the accessories that 
come with the ICD. Your ICD has a few special features that 
you should know about, too; you can find information about 
these features in this section as well. 

You shouldn't try to attach the ICD to any external device 
before you finish reading this section. As long as the power 
cord is disconnected you can't hurt anything internally, but 
don't connect the ICD to your target system before you read, 
"How to Connect Your ICD to Other Devices." Although it's 
difficult, it is possible to get the cables to the target system 
reversed, which could result in damage to the ICD's internal 
components. 

Your ZAX ICD-series in-circuit emulator is a microprocessor 
emulation device that can be used for developing and main- 
taining microprocessor-based systems. It does this by letting 
you direct and test activities in your prototype ("target") 
system. You perform these operations by entering one or 
more debugger commands. 

All ZAX ICD-series emulators are controlled by a separate 
terminal or in conjunction with your existing host computer 
system. You can use the debugger commands for your hard- 
ware or software projects by simply inputting the command 
mnemonics and parameters from just about any terminal or 
popular computer you might own. 
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A Few Features Here are just a few things you can do using the debugger 

commands: 

■ Use the ICD’s emulation memory to simulate or take the 
place of memory (or future memory) in your target system, 

■ Use a single-step trace operation to move through your pro- 
gram, one step at a time, and examine the register's con- 
tents after each step. 

■ Set a combination of hardware and software breakpoints to 
stop your program when: data is written or read into a 
specific address, an event point is passed, a non-existent 
memory access is attempted, or an interrupt is acknowl- 
edged by the CPU. Hardware breakpoints can also gener- 
ate triggers for instruments such as logic analyzers and 
oscilloscopes. 

■ Record ("trace”) a portion of your program (beginning and 
ending anywhere within the program) and store it in the 
ICD's real-time trace buffer vnthout affecting the emulation 
process. Later you can display the recorded memory con- 
tents in either machine code or in its disassembled format. 

■ Translate symbolic codes into machine instructions, item 
for item, using the in-line assembler. 

■ Selectively enable and disable the interrupt or bus request 
inputs— including non-maskable interrupts. 

You can turn to Section 2 for a complete list of the ICD's de- 
bugger commands. Tb find out about other things your ICD 

can do, turn to "More About Your ICD” 

Now turn the page to learn about the parts of your ICD. 
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The Controls And 
Component Functions 
OtYour ICD 

@ AC Power Select Switch. This switch is used to select the 
power requirements for the ICD. Set the switch to 110V/117V to 
run on a power supply of 1 10-120VAC, or select 200V/240V to 
run on a power supply of 200-240. 

(D AC POWER CORD Receptacle. Accepts female end of the 

supplied three-wire power cord. Be sure to disconnect the 
power cord before moving the ICD. 

@ DC FAN Receptacle. Accepts connector end of the 24V DC 
fan. 
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® TERMINAL Port Connector. Accepts male end of an RS-232 
cable to attach the ICD to a terminal in a stand-alone (LOCAL 
mode) configuration. When using the ICD in the REMOTE 
mode, this port can be used as an auxiliary I/O. 

® HOST/AUX Port Connector. Accepts male end of an RS-232 
cable to attach the ICD to a host computer system when the 
ICD is operating in the REMOTE mode. ICD commands can 
then be entered using the computer's keyboard. When using 
the ICD in a stand-alone (LOCAL mode) configuration, this port 
dumps object code, registers, or memory to a host computer or 
printer, 

® LOCAL/REM (Local/Remote) Select Switch. This switch is 
used to select which port (TERMINAL or HOST/AUX) the ICD 
will use to receive commands . 

® BAUDRATE Switches (TERMINAL and HOST/AUX). These 
switches are used to set the baud rates for the TERMINAL and 
HOST/AUX ports. The factory setting is #1—9600 bps. Tb 
change the baud rates of the ICD, see "Technical References”; 
SIO module. 

® DCE/DTE Select Switch. This switch is used to set the HOST/ 
AUX port to either RS-232 data terminal equipment (DTE) or 
data communications equipment (DCE). Use the DTE setting if 
the ICD is used with a host computer. Use the DCE setting if a 
printer is connected to the HOST/AUX port. (The TERMINAL 
port is always DCE.) 

® DB. EMUL (Data Bus Emulation) Connector. Accepts female 
end of the Data Bus Emulation Cable, (See "More About Your 
ICD” for details on how to use this cable.) 

® Top In-circuit Probe Receptacle. Accepts female end of the 

Top In-circuit Probe. 

® Bottom In-circuit Probe Receptacla Accepts female end of the 
Bottom In-circuit Probe. 
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E.M. SEL (Emulation Select) Switch. This switch is used to set 
the machine cycle operation to the target system. (See "More 
About Your ICD" for details on what this switch does.) 


EXT. BRK. (External Break) Connector. Accepts female end of 
the External Break/Map Control cable. (See "More About 

Your ICD" for details about how to use this cable.) 


EVENT TRG. (Event Trigger) Connector. Accepts female end 
of the Event Trigger/Emulation Qualify Cable. (See "More 
About Your ICD" for details about how to use this cable.) 


(8^ 
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® POWER ON/OFF SWITCH. This switch is used to supply 
power to the ICD. 

® CLOCK INT/EXT SWITCH. This switch is used to select either 
the ICD's internal clock (INT) or the target system's clock 
(EXT = external). 

® HALT Lamp. This LED comes on after the ICD's CPU has 
stopped executing a HELP instruction or when a BUSAK (BUS 
ACKNOWLEDGE) is in progress. 

® RESET Switch. This switch is used to reset the ICD monitor. You 
can push it any time the MONITOR lamp is lit. After you push 
the RESET switch, you'll see the ICD's identification message 
on your terminal's monitor. 

® MONITOR Lamp. This LED comes on to indicate that control is 
currently in the ICD's monitor. It will not be lit during 
emulation, 

@ ICE (In-Circuit Enable) Lamp. This LED comes on when the 
ICD is operating in the in-circuit mode II or 12. 

@ MONITOR Break Switch. This switch is used to return control 
to the ICD monitor during emulation. 

@ POWER Tramp. This LED comes on to indicate that power is 
being supplied to the ICD. 
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Now turn to the next chapter to learn how to connect your ICD 
to your system. 
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Section 1 


How to Connect 
Your ICD To 
Other Devices 

Your Goal: A 
Microprocessor 
Development System 


Your System’s 
Environment 


In the main introduction you read that properly connecting the 
ICD to your system was one of the most important things you 
would learn in this manual, The following information will show 
you how to connect the ICD's components, what cables to con- 
nect and where they go, and which switches are set to what 
positions. Once you have completed the procedures outlined 
in this chapter, you’ll have what is called a "Microprocessor 
Development System" (MDS). By using the commands and 
applications found in Section 2, you’ll be able to perform a 
remarkable variety of debugging operations with your MDS. 


Before you connect your ICD to anything, you’ll need to answer 
three guestions about your system’s environment. First, will 
Second, will you control the system with a terminal or a host 
computer? And third, if a terminal is used to control the ICD, 
will a host computer be used as a source for data files? 
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Hardware or Software? 


Your hardware is called a "target system." By physically re- 
moving the CPU in your system and electronically replacing it 
with the ICD’s internal microprocessor, you can control, test, 
and check almost all possible functions in your target system, 
If this is the mode you’ll be operating in, look at the three sys- 
tem configurations in USING THE ICD WITH A TARGET 
SYSTEM. 

Can you use your ICD without a target system? Of course! 
Whenever you develop and debug software you'll be doing it 
without the use of a target system. This mode is also an effec- 
tive way to demonstrate some of your ICD’s features. If this is 
the mode you’ll be operating in, look at the three system con- 
figurations in USING THE ICD WITHOUT A TARGET SYSTEM. 
(In fact, if this is the first time you are using a ZAX emulator, you 
should construct this system configuration and then turn to Ap- 
pendix B at the back of the manual. There you will find a 
demonstration of the functions and features of your ICD.) 
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Terminal or Host If you'll be controlling the ICD by a console terminal, it's called 

Computer Controlled? TERMINAL CONTROL OF THE ICDi In this mode, the ICD 

"stands alone" (hence the name, stand-alone emulator) or apart 
from the auxiliary control of a host computer system. The ICD 
assumes a stand-alone mode of operation when you place the 



If you'll be controlling the ICD with a host computer and using 
the utility software program ZICE, it's called HOST COM- 
PUTER CONTROL OF THE ICD. The ICD assumes this mode 
of operation when you place the LOCAL/REM switch to the 



MO ZAX Corporation 


ICD-278forZ80 










Section 1 


ICD DESCRIPTION & OPERATION 


Finally, you may choose to control the ICD with a terminal and 
use a separate host computer to store data files, or connect a 
printer to the host computer to dump data for hard copies. This 
mode of operation is called TERMINAL CONTROL OF THE 
ICD (WITH HOST DATA HLES). In this mode, the ICD is stUI 
under direct control of the terminal while the host computer 
serves as a data storage device. You can also cause the ICD to 
assume a "transparent” condition, which allows direct com- 
munication between the terminal and host computer. 




NOTE: ZICE software may be used in the LOCAL mode: Ter- 
minal Control Of The ICD (With Host Data Files), for accessing 
the ZICE commands (help files, ’Z" commands, eta). To use this 
LOCAL "host computer assisted" mode, see the HOST com- 
mand in Section 2. 
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ICD DESCRIPTION & OPERATION 


Section 1 


Reviewing The 

Operation Modes Now let's review the six different operation modes of your ICD. 


USING THE ICD WITHOUT 

A TARGET SYSTEM 

■ Terminal Control of the 
ICD-LOCAL mode of 
operation 

■ Terminal Control of the 
ICD (With Host Data Files) 
—LOCAL mode of 
operation 

■ Host Computer Control of 
the ICD— REMOTE mode 
of operation 


USING THE ICD WITH 

A TARGET SYSTEM 

■ Terminal Control of the 
ICD-LOCAL mode of 
operation 

■ Terminal Control of the 
ICD (With Host Data Files) 
—LOCAL mode of 
operation 

■ Host Computer Control of 
the ICD— REMOTE mode 
of operation 


Summing It All Up . . . 


■ Your ICD can function in any of six different modes. 

■ Your ICD can be used to debug hardware or software. 


■ Your ICD can operate with or without a target system. 

■ Your ICD can dump data directly to a printer. 

■ Your ICD can dump data to a printer attached to a host com- 
puter. 

■ Your ICD can be controlled by just a terminal or by a host 
computer. 

■ Your ICD can be controlled by a terminal and then use a 
separate host computer for storing data files or outputting 
data to a printer. 

■ Your ICD can be controlled by a terminal and then use a 
separate host computer for accessing the ZICE commands. 

Now turn the page cuid read about preparing a site for your 

system. 

M2 ZAX Corporation ICD-278 for Z80 


Section 1 ICP DESCRIPTION & OPERATION 

System Preparation Read This Before You Connect Anything! 

Grounds Your ICD is equipped with a three-wire polarized receptacle 
that accepts a three-wire cord. This cord connects to a power 
source and protective ground. Make sure that you plug the 
power cord into a properly grounded 115 VAC receptacle. Do 
not try to bypass the three-prong plug wth an adaptor (3- into 
2-prong adaptor). 

THE GROUND TERMINAL OF THE PLUG IS USED TO PRE- 
VENT SHOCK HAZARDS— DO NOT BYPASS IT! 

Power Your ICD is normally set to operate on a voltage supply of 
110-120 VAC. but this can be changed to 200-240 VAC by setting 
the Power Select Switch to the 200V/240V position. 

In most cases, a multiple power outlet strip should be used to 
provide voltage to the entire system (host computer, terminal, 
printer, target system). Most power outlet strips are equipped 
with a circuit breaker in case of an overload, and all are 
properly grounded. 

No matter what type of power source you use, always apply 
power after connecting the ICD to an electrical outlet, and 
always apply power in the same sequence: switch on the 
power supply first, and then press the POWER-ON switch. 


Important Facts About The 
CPU In-Circuit Probe 



TOP 


The CPU In-circuit Probe is used to connect the ICD to your 
target system. The probe consists of a 20-inch ribbon cable 
with three end connectors. The 40-pin connector end of the 
probe plugs into the target system's microprocessor socket. On 
the other end of the probe are two sockets which plug into the 
ICD's In-circuit Probe receptacles. The sockets are labeled 
TOP and BOTTOM and MUCT be placed in the corresponding 
topp and bottom receptacles. 

CAtJTION: DO NOT REVERSE PROBE CONNECTIONS. MIS- 
MATCHING THE TOP AND BOTTOM SOCKET CONNEC- 

Tflli!9SJnjIufi5iTI®^ cnrcpf fh/-i rnTjT’ iiikTTN 

Now turn to the appropriate heading on the next few pages to 
construct your microprocessor development system. 
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Section 1 


USING THE ICD WITHOUT A TARGET SYSTEM 
(TERMINAL CONTROLLED) 

System Configuration: Terminal control of the ICD 
Operation Mode: LOCAL 

Facilities needed for this system configuration: ICD, Console Terminal, 
0) RS-232 cable. 


To use the ICD in this mode, construct the system configuration shown on the opposite page 
using the information below. 


First . . . 

Make sure that the power to the ICD and all externally attached devices (terminal, printer) is 

OFF, then proceed as follows: 

1) Attach the COOLING FAN to the ICD and then plug the fan's connector to the receptacle 
labeled DC FAN POWER. 

2) Connect your terminal to the ICD by using an RS-232 cable. Attach the cable from your ter- 
minal's serial (EIA RS-232) port to the ICD's TERMINAL port connector. The ICD defaults to 
9600 baud, 8 data bits, 2 stop bits and no parity: set up your terminal to these specifications. 

3 ) (Optional) Connect your printer to the ICD by using an RS-232 cable. Attach the cable from 
your printer to the ICD’s HOST/AUX port connector. 

4 ) Plug the AC POWER CORD into the ICD's power receptacle and then connect the other end 
of the cable to a power source. 


Now Set This: 


To This: 

100V/117V 200V/240V 

> 

110V/117V 

LOCAL/REM 

> 

LOCAL 

INT/EXT 

> 

INT 

DCE/DTE 

> 

DCE 

Baud Rates 

> 

9600 bps (NOTE: To change the ICD's baud 
rates, see the chart on the opposite page.) 

POWER ON/OFF Switch 

>- 

ON 


The following message should now appear on your monitor’s screen (you may have to press the 
ICD-278forZ80 V2.0 

Now turn to page 1-26. 
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Section 1 


ICD DESCRIPTION & OPERATION 


Q Terminal’s EIA RS-232 port 
© ICQ'S TERMINAL port 

© Use chart below to change baud rote tor ICQ’S TERMINAL port 


TERMINAL 



Baud Rate Switch No. 

0 

a 

D 

a 

[T] 


B 

[H 

8 


A 

D 

B 

B 

11 

F 

Baud Rate (bps] 

'I9.2K 



BBS 

ABB 

B!8H 



m 

QQ 

134.5 

BiBl 




- 
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Section 1 


USING THE ICD WITHOUT A TARGET SYSTEM 
(TERMINAL CONTROLLED/HOST STORAGE) 

System Configuration: Terminai controi of the ICD (with host data flies) 
Operation Mode: LOCAL 

Facilities needed for this system configuration: ICD, Console Terminal, 

Host Computer, (2) RS*232 cables. 

To use the ICD in this mode, construct the system configuration shown on the opposite page 
using the information below. 

First . . , 

Make sure that the power to the ICD and all externally attached devices (terminal, printer, host 
computer) is OFF, then proceed as follows; 

1) Attach the COOLING FAN to the ICD and then plug the fan's connector to the receptacle 
labeled DC FAN POWER, 

2) Connect your terminal to the ICD by using an RS-232 cable. Attach the cable from your ter- 
minal’s serial (EIA RS-232) port to the ICD's TERMINAL port connector. The ICD defaults to 
9600 baud, 8 data bits, 2 stop bits and no parity: set up your terminal to these specifications. 

3) Connect your host computer to the ICD by using an RS-232 cable. Attach the cable from your 
host computer’s serial (EIA RS-232) port to the ICD’s HOST/AUX port connector. 

4) Plug the AC POWER CORD into the ICD’s power receptacle and then connect the other end 
of the cable to a power source. 


Now Set This: 


To This: 

100 V/ 117V 200V/240V 

> 

110V/117V 

LOCAL/REM 

> 

LOCAL 

INT/EXT 

> 

INT 

DCE/DTE 

> 

DTE if you’re using ZAX’s BOX microcom- 
puter, DCE for other personal computers. 

Baud Rates 

> 

9600 bps (NOTE: To change the ICD's baud 
rates, see the chart on the opposite page.) 

POWER ON/OFF Switch 

> 

ON 


The following message should now appear on your monitor’s screen (you may have to press the 
RESET switch on the ICD): 

ICD-278 for Z80 V2.0 


Now turn to page 1-26, 
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ICD DESCRIPTION & OPERATION 


Q Terminal's EIA RS-232 port 
© ICD-s TERMINAL port 
© ICG’s HOST/AUX port 
G Computer's SIO port 

@ Use chart below to change baud rates tor ICG's TERMINAL and HOST/AUX ports 


TERMINAL 


HOST STORAGE 



Baud Rate Switch No. 

0 

a 

D 

B 

o 

B 

B 

B 

B 


Bi 

B 

B 

B 

B 

D 

Baud Rate (bps) 

'I9.2K 


HEIB 


ilBS 

0^ 

Hil3 

B3il 

m 

npi 

134.5 
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ICD DESCRIPTION & OPERATION 


Section 1 


USING THE ICD WITHOUT A TARGET SYSTEM 
(HOST COMPUTER CONTROLLED) 

System Configuration: Host computer control of the ICD 
Operation Mode: REMOTE 

Facilities needed for this system configuration: ICD, Host Computer, 

ZICE software, (1) RS-232 cable. 

To use the ICD in this mode, construct the system configuration shown on the opposite page 
using the information below. 

First . . . 

Make sure that the power to the ICD and all externally attached devices (host computer, 
printer) is OFF, then proceed as follows: 

1) Attach the COOLING FAN to the ICD and then plug the fan's connector to the receptacle 
labeled DC FAN POWER. 

2 ) Connect your host computer to the ICD by using an RS-232 cable. Attach the cable from your 
host computer’s serial (EIA RS-232) port to the ICD's HOST/AUX port. 

3 ) Plug the AC POWER CORD into the ICD's power receptacle and then connect the other end 
of the cable to a power source. 


100V/117V 200V/240V 

> 

LOCAL/REM 

> 

INT/EXT 

> 

DCE/DTE 

> 

Baud Rates 

> 

POWER ON/OFF Switch 

> 


liov/nyv 

REM 

INT 

DTE if you’re using ZAX's BOX microcom- 
puter; DCE for other personal computers. 
9600 bps (NOTE: To change the ICD's baud 
rates, see the chart on the opposite page.) 
ON 


At this point, you will have to load the ZICE software program necessa^ for interfacing the ICD 
to your host computer. Execute the program loading commands as outlined in the ZICE software 
documentation. 


The following message should now appear on your monitor's screen (you may have to press the 
RESET switch on the ICD): 

ICD-278 for Z80 V2.0 

<3 

Now turn to page 1-26. 
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ICD DESCRIPTION & OPERATION 


O ICD’s HOST/AUX port 

® Host computer’s SiO port 

® Use cKort below to change baud rote for ICD’s Host/AUX port 


HOST COMPUTER 



Baud Rate Switch No. 

0 

a 

B 

B 

B 

B 

B 

B 

B 


D 

B 

Bi 

B 

B 

F 

1 

19.2K 

HBB 

ElEIB 


nH5 



nsi 

m 

ilBI 

HtSlnl 

Hgil 
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ICD DESCRIPTION & OPERATION 


Section 1 


USING THE ICD WITH A TARGET SYSTEM (TERMINAL CONTROLLED) 

System Configuration: Terminal control of the ICD 

Operation Mode: LOCAL 

Facilities needed for this system configuration: ICD, Console Terminal, 

Target System, CPU Imclrcult Probe, 0) RS’232 cable. 

To use the ICD in this mode, construct the system configuration shown on the opposite page 

using the information below. 

First . . . 

Make sure that the power to the ICD and all externally attached devices (terminal, printer, 

target system) is OFF, then proceed as follows: 

1) Attach the COOLING FAN to the ICD and then plug the fan's connector to the receptacle 
labeled DC FAN POWER. 

2) Connect your terminal to the ICD by using an RS-232 cable. Attach the cable from your ter- 
minal’s serial (EIA RS-232) port to the ICD's TERMINAL port connector. The ICD defaults to 
9600 baud, 8 data bits, 2 stop bits and no parity: set up your terminal to these specifications. 

3) (Optional) Connect your printer to the ICD by using an RS-232 cable. Attach the cable from 
your terminal to the ICD’s HOST/AUX port connector. 

4) Remove the existing (Z80) CPU from your target system and insert the IN-CIRCUIT PROBE 
(40-pin end) socket into the target system’s CPU socket (pin 1 of the ICD’s In-circuit probe 
socket goes into pin 1 of the target system’s CPU socket). Connect the other end of the 
IN-CIRCUIT PROBE to the ICD’s TOP and BOTTOM In-circuit Probe Receptacles. THE 
LONGEST CABLE MUST BE CONNECTED TO THE TOP IN-CIRCUIT PROBE 
RECEPTACLE. 


5 ) Plug the AC POWER CORD into the ICD’s power receptacle, then connect the other end of 
the cable to the same power source that is used by your target system. 


Now Set This: 


To This: 

100V/117V 200V/240V 

> 

'I10V/1'I7V 

LOCAL/REM 

> 

LOCAL 

INT/EXT 

> 

EXT 

DCE/DTE 

> 

DCE 

Baud Rates 

> 

9600 bps (NOTE: To change the ICD's baud 
rates, see the chart on the opposite page.) 

POWER ON/OFF Switch 

> 

ON 


The following message should now appear on your monitor’s screen (you may have to press the 
RESET switch on the ICD): 

ICD-278forZ80 V2,0 

Now turn to page 1-26. 
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ICD DESCRIPTION & OPERATION 


Q Terminal’s EIA RS-232 port 
© ICD’s TERMINAL port 
@ ICD’s In-circult probe receptacle 

G Target system’s CPU socket 

Q Use chart below to change baud rate for ICD’s TERMINAL port 


TERMINAL 
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Section 1 


USING THE ICD WITH A TARGET SYSTEM 
(TERMINAL CONTROLLED/HOST STORAGE) 

System Configuration: Terminal control of the ICD (with host data files) 
Operation Mode: LOCAL 

Facilities needed for this system configuration: ICD, Console Terminal, 

Host Computer, Target System, CPU In-circuit Probe, (2) RS-232 cables. 

To use the ICD in this mode, construct the system configuration shown on the opposite page 
using the information below. 

First . . . 

Make sure that the power to the ICD and all externally attached devices (terminal, printer, host 
computer, target system) is OFF, then proceed as follows: 

1) Attach the COOLING FAN to the ICD and then plug the fan’s connector to the receptacle 
labeled DC FAN POWER. 

2) Connect your terminal to the ICD by using an RS-232 cable. Attach the cable from your ter- 
minal's serial (EIA RS-232) port to the ICD’s TERMINAL port connector. The ICD defaults to 
9600 baud, 8 data bits, 2 stop bits and no parity: set up your terminal to these specifications. 

3) Connect your terminal to the ICD by using an RS-232 cable. Attach the cable from your host 
computer's serial (EIA RS-232) port to the ICD’s HOST/AUX port connector. 

4) Remove the existing (Z80) CPU from your target system and insert the IN-CIRCUIT PROBE 
(40-pin end) into the target system's CPU socket (pin I of the ICD’s In-circuit probe socket 
goes into pin 1 of the target system's CPU socket). Connect the other end of the IN-CIRCUIT 
PROBE to the ICD's TOP and BOTTOM In-circuit Probe Receptacles. THE LONGEST 
CABLE MUST BE CONNECTED TO THE TOP IN-CIRCUIT PROBE RECEPTACLE. 

5 ) Plug the AC POWER CORD into the ICD 's power receptacle , then connect the other end of 
the cable to the same power source that is used by the target system. 


Now Set This: 


To This: 

-lOOV/IIZV 200V/240V 

> 

IIOV/IIZV 

LOCAL/REM 

> 

LOCAL 

INT/EXT 

> 

EXT 

DCE/DTE 

> 

DTE if you're using ZAX's BOX microcom- 
puter; DCE for other personal computers. 

Baud Rates 

> 

9600 bps (NOTE: To change the ICD's baud 
rates, see the chart on the opposite page.) 

POWER ON/OFF Switch 

> 

ON 


The following message should now appear on your monitor’s screen (you may have to press the 
RESET switch on the ICD): 

ICD-278 for Z80 V2.0 

Now turn to page 1-26. 
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Q Terminal’s EIA RS-232 port 

© ICQ’S TERMINAL port 

® ICQ’S HOST/AUX port 

G Computer’s SIC port 

@ ICQ’S In-elreult probe receptacle 

G Target system’s CPU socket 

@ Use chart below to change baud rotes tor ICQ’s TERMINAL and HOST/AUX ports 


TERMINAL 


HOST STORAGE 



TARGET SYSTEM 



Baud Rate Switch No. 

0 


B 

B 

D 

B 

B 

B 

8 


mm 

B 

Bi 

B 

B 

D 

Baud Rate (bps] 

'I9.2K 


HEIB 


nB!i 




B 

npi 

134.5 

BiBl 


Q9 
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Section 1 


USING THE ICD WITH A TARGET SYSTEM 
(HOST COMPUTER CONTROLLED) 

System Configuration: Host computer control of the ICD 
Operation Mode: REMOTE 

Facilities needed for this system configuration: ICD, Host Computer, 

ZICE Software, Target System, CPU In-circult Probe, (1) RS-232 cable. 

To use the ICD in this mode, construct the system configuration shown on the opposite page 
using the information below. 

First . . . 

Make sure that the power to the ICD and all externally attached devices (host computer, 
printer, target system) is OFF, then proceed as follows: 

1) Attach the COOLING FAN to the ICD and then plug the fan’s connector to the receptacle 
labeled DC FAN POWER. 

2) Connect your host computer to the ICD by using an RS-232 cable. Attach the cable from your 
host computer’s serial (El A RS-232) port to the ICD’s HOST/AUX port connector. 

3) Remove the existing (Z80) CPU from your target system and insert the IN-CIRCUIT PROBE 
(40-pin end) into the target system’s CPU socket (pin 1 of the ICD’s In-circuit probe socket 
goes into pin 1 of the target system’s CPU socket). Connect the other end of the IN-CIRCUIT 
PROBE to the ICD’s TOP and BOTTOM In-circuit Probe Receptacles. THE LONGEST 
CABLE MUST BE CONNECTED TO THE TOP IN-CIRCUIT PROBE RECEPTACLE. 


4 ) Plug the AC POWER CORD into the ICD’s power receptacle, then connect the other end of 
the cable to the same power source that is used by the target system. 


Now Set This: 


To This: 

100V/117V 200V/240V 

> 

110V/U7V 

LOCAL/REM 

> 

REM 

INT/EXT 

> 

EXT 

DCE/DTE 

> 

DTE if you’re using ZAX’s BOX microcom- 
puter; DCE for other personal computers. 

Baud Rates 

> 

9600 bps (NOTE: To change the ICD’s huad 
rates, see the chart on the opposite page.) 

POWER ON/OFF Switch 

> 

ON 


At this point, you will have to load the ZICE software program necessary for interfacing the 
ICD to your host computer. Execute the program loading commands as outlined in the ZICE 
software documentation. 


The following message should now appear on your monitor’s screen (you may have to press the 
RESET switch on the ICD): 

ICD-278forZ80 V2.0 

Now turn to page 1-26. 
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Q ICQ’S HOST/AUX port 

© Host computer’s SIO port 

@ ICQ’S In-elreult probe receptacle 
G Target systertVs CPU socket 

G Use chart below to change baud rate tor ICQ’s HOST /AUX port 


HOST COMPUTER 



TARGET SYSTEM 
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Section 1 


What Can You Do 
With Your MDS7 


What To Do If Your MDS 
Is Not Working 


You should now have a fully operational Microprocessor De- 
velopment System (MDS) capable of developing and debug- 
ging your hardware or software designs. If your MDS is func- 
tioning correctly, and the ICD’s identification message appear- 
ed on your monitor's screen, you can now: 

■ Turn to the "Master Command Guide" for a complete 
analysis of your ICD's debugger commands. 

■ Turn to Appendix B for a demonstration of the features and 
functions of your ICD. 

■ Use the "Command Reference Guide" as a source for 
various command formats. 

If your MDS is not functioning correctly, or gives you prob- 
lems during emulation, turn to "Trouble Shooting" which starts 
on the next page. Start by reading "Checking Electrical Con- 
nections" and then proceed to "Diagnosing ICD Interface 
Problems" if you encounter problems when you're emulating. 



COMMAND 

REFERENCE 

GUIDE 


SECTION 2 
MASTER 
COMMAND 
GUIDE 



APPENDIX B 

TROUBLE 

SHOOTING 


0 

0 
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ICD DESCRIPTION & OPERATION 

Trouble Shooting (contains “Checking Electrical Connections” and 
“Diagnosing ICD Interface Problems”) 

Introduction: 
The Problem . . . 

Your ICD must be controlled by either a separate terminal or 
a host computer’s keyboard. And, because you must connect 
the ICD to these external devices to form your development 
system, there’s always the possibility of misplacing a cable, set- 
ting a switch to the wrong position, or bypassing a procedure. 

. . . And The Solution! 

“Trouble Shooting” is designed to get you through the prob- 
lems you might have encountered in “How To Connect Your 

ICD To Other Devices,” and begins with a typical example of 
what the ICD should do if the system is operating correctly, 

Then the ICD by itself is tested, followed by testing the ICD 
and terminal. ICD, terminal, and target system configuration 
is then examined. 

What Should Happen 

When the ICD is connected to a terminal (keyboard and mon- 
itor), the following should happen: 


When the ICD’s POWER ON/OFF switch is pressed, the PWR 
(power) and MONITOR lamps should come on, and the exter- 
nal cooling fan should be running. The terminal’s monitor 
should then show the ICD’s identification message after a few 
seconds; 


ICD-278 for Z80 V2.0 


(If the ID message does not appear, try pressing the RESET 
switch.) A prompt (>) should also appear, indicating that the 
system is working properly and that the ICD is ready to accept 
commands. At this point, any of the “status commands” (com- 
mand name followed by a RETURN) can be entered. 


They include: B, EV, H, I, MA, O, PI, R, SU, T 


Try entering a few of the status commands. If the response 
from the ICD is the command’s status, then the system is prob- 
ably functioning properly. Otherwise, continue reading and 
follow the procedures outlined in this chapter. 

ICD-278forZ80 
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Section I 


How To Get Your In this trouble shooting session you'll start by disconnecting 
ICD Working the ICD from all external devices such as the target system, 

host computer, or terminal. Then you’ll check the ICD by itself 
(just connect its power cord), then attach a terminal. If that con- 
figuration works properly, you'll connect your target system 
for final testing. 

NOTE: If you're using a host computer to control the ICD, be 
sure to check the ICD and host computer operation together 
BEFORE connecting your target system. 

Now begin with "Checking Electrical Connections.” 

Checking Electrical 1. Press the ICD's POWER ON/OFF switch to OFF. 

Connections 2. Turn the power OFF on all externally attached devices (ter- 
minal, host computer, target system, etc.). 

3. Disconnect all externally attached devices from the ICD. 

4. Unplug the AC power cord from the ICD and from the wall 
outlet or power supply. 

5. Check the wall outlet or power supply by plugging in a 
working device (lamp, terminal, logic analyzer, etc.). If the 
outlet or power supply is controlled by a switch, is the switch 
ON? 

6. Disconnect and reconnect each device's AC power cord to 
ensure a proper electrical connection. 

Proceed with "Diagnosing ICD Interface Problems" on the 
next page. 
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ICD DESCRIPTION & OPERATION 


Diagnosing ICD Interface 
Problems 

ICD and External 
Cooling Fan 

PROBLEM: 
The external cooling fan 
doesn’t work. 


The fan works but the lamps 
on the Operators Panel don’t 
come on. 


Connect the External Cooling Fan to the ICD and then connect 
the ICD’s power cord to a voltage source. 

SOLUTION; 

What’s Probably Wrong: 

The fan is not getting power. 

What To Do: 

Make sure that the fan connector is firmly pressed into the 
ICD’s fan receptacle and that the POWER ON/OFF switch is in 
the ON position. 

What’s Probably Wrong: 

There is an internal problem with the ICD. 

What To Do: 

Return the ICD for servicing. 

If this checks out, the ICD is probably working correctly. Now 
connect a terminal (no target system yet) to the ICD and carry 
out the next procedure. 
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ICD and Terminal 


PROBLEM 
The terminal does not 
respond at all when the 
RESET switch is pressed. 


Terminal responds with 
"gibberish” when the 
RESET switch is pressed. 


Terminal responds with a 
C?> error message when 
any of the commands are 
.entered. 


Before you begin, make sure that your terminal is working 
properly (i.e, the curser on the screen should be visible). Then 
connect the ICD to the terminal with an RS-232 cable. 

SOLUTION 

What's Probably Wrong: 

There is either an interface problem or a defect with a com- 
ponent in the system. 

What To Do: 

First make sure that the RS-232 cable is firmly attached to both 
the ICD and terminal connectors. Is the cable defective? If the 
cable is OK, check that the INT/EXT CLOCK switch is set to 
INT and that the LOCAL/REM switch is set to LOCAL. Make 
sure that both the ICD and the terminal have been set at the 
same baud rates. 

What's Probably Wrong: 

The baud rates for the ICD and terminal are different. 

What To Do: 

Make sur^^that the baud rates for the ICD and the terminal are 
What's Probably Wrong; 

On some terminals, the ICD will only recognize a command 
that is stated with capital letters (e.g., R not r). 

What To Do: 

Press the Lock or Caps Lock button on your keyboard to the 
locked position. 

If you've reached this point with no problems, your difficulty 
probably lies in the ICD failing to emulate your target system. 
Now connect the ICD to your target system and then read 
through the next checkout procedure. 
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ICD with Target System 
Connected 

PROBLEM 
Terminal doesn't work 
properly. 


Terminal works all right but 
the ICD still doesn't emulate 
properly. 


Connect the target system to the ICD using the CPU in-circuit 
probe. Use a terminal to control the ICD. 

SOLUTION 

What's Probably Wrong: 

There is either an interface problem or a defect with a com- 
ponent in the system. 

What To Do: 

Check that the ICD is properly connected to your target sys- 
tem, that the target system has power, and that the terminal is 
set up correctly. Select the EXTERNAL (EXT) clock, and press 
the RESET switch on the ICD. The ICD’s identification message 
and prompt should appear. If no prompt appears on EXTER- 
NAL clock setting, switch to INTERNAL (INTO clock and press 
RESET again. (With INT selected, the ICD and terminal should 
work independently of your target system.) 

If the ICD operates on the INT setting, the problem is probably 
a poor clock signal from your target system. It is possible to use 
the ICD with the INT setting but you will lose real-time oper- 
ation. 

NOTE: In this next checkout procedure, you will need to enter 
certain commands in order to test the system. See "Master 
Command Guide" for an explanation of how to enter these 
commands. 

What’s Probably Wrong: 

There is a problem with data bus loading, interrupt process- 
ing, or the target system being disturbed during an emulation 
break. 
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What To Do: 

Step 1. Select in-circuit mode 2 QZ) (see IN-CIRCUIT com- 
mand) and start your program by entering the GO command. 
(This assumes there are ROMs in your target system. If there 
aren't any, then mode 2 will not work; proceed to Step 2.) 
Now test your target system. If it still doesn’t work, then there 
is probably a data bus loading problem. Adding pull-up 
resistors to the data bus may help. 

Step 2. If the in-circuit mode 2 works, try mode II. If there are 
ROMs in the system, copy the ROMs to emulation memory (use 
the MOVE command). The start address is 0, and the end 
address is 07FF for 2K bytes, OFFF for 4K bytes, and IFFF for 
8K bytes. If the ROMs are not all at adjacent addresses, then 
additional move commands will be needed. If there are no 
ROMs in the system, you will need to download the program 
from the host computer. Map all memory except the program 
memory to your target system (mapping code US). Select in- 
circuit mode 1 (II), and start your program (GO command). 
Check to see if your target system is working properly now. If 
not, the problem could be related to interrupt processing (see 
next page). 

Step 3. If the ICD works in the in-circuit mode 1 (II), check for 
problems during an emulation break. If your target system 
works at the start of emulation, but fails when it is stopped and 
restarted, then the target system is probably being disturbed 
during an emulation break. This may be because your target 
system's design uses RD or Ml without gating them with 
MREQ. If this is the problem and you cannot modify your 
system, then the ICD can probably be modified by ZAX. 
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What To Do If The ICD 
Still Doesn't Work 


Interrupt Processing Problems; 

Is the target system data bus buffered between the micropro- 
cessor and the peripheral chips? Are Z80 family peripheral 
chips (PIO, SIO, CTC) used? If the answer to either question is 
no, then the ICD should not cause any problems with interrupt 
processing. 

If the data bus is buffered and Z80 peripheral chips are used, 
then the problem occurs when MREQ is not decoded by the 
buffer direction control logic. The easiest solution is to remove 
the data bus buffer and replace it with jumpers. If this is not 
possible, then the Emulation Data Bus connector (the connec- 
tor labeled DB.EMUL on the ICD) can be connected to the buf- 
fered data bus. (See "More About Your ICD— Data Bus Emu- 
lation Connector.) 

In most cases, the procedures just listed will solve all but the 
most stubborn problems. However, it is possible that the ICD 
or your target system is still not functioning correctly. If this is 
the case, you should consult directly with ZAX Corporation. 
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Introduction 

Here you’ll learn how to use the accessories that come with 
your ICD and what the Emulation Select switch does. By using 
the accessories and adjusting the settings on the switch, you'll 
be able to further expand your ICD’s debugging capabilities. 


From the following information, you will learn how to; 1) use 
the two accessory cables, 2) use the Data Bus Emulation con- 
nector, and 3) adjust the settings on the Emulation Select 
switch. 

Accessory Cables 

The two accessory cables can be used to input and output 
pulses to and from the ICD. By using the four probes that are 
attached to the ends of these cables, you can: 


• Determine if the ICD is emulating. 


• Cause a breakpoint in your program to output a pulse to an 
external device. 


• Selectively access either ROM or RAM. 


• Cause the ICD to insert a break in your program when an 
external pulse is sensed. 

Data Bus Emulation 
Connector 

The Data Bus Emulation connector bypasses the Bi-directional 

Bus transceiver and forcibly outputs a RETI instruction to 
various Z80 peripheral chips (CTC, PIO, etc.) after an interrupt 
occurs. 

Emulation Select Switch 

The Emulation Select switch lets you: 1) use the Data Bus Emu- 
lation connector (by disabling the ICD’s data bus from the 
target system's data bus), 2) send or suppress the RD signal, 
and 3) insert 1, 2, or 3 wait states into a machine cycle. 
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Probe 

Probe 

Accessory Cables & Probes 

Probe 


Name 

Color 

Location 

What The Probe Does 

How It's Used 

Emulation WHITE 
Qualify 

BLUE wire of 
the Event 
Trigger cable 

Outputs a HIGH level signal 
from the ICD to the Emula- 
tion Qualify probe during 
emulation. During the 
MONITOR mode (breakpoint 
encountered or MONITOR 
button pressed) the signal 
level is LOW. 

The EQ signal can be used 
as an “emulation in progress" 
indicator or to remove 
unwanted signals during 
emulation. 

Event 

Trigger 

GREEN 

BLUE wire of 
the Event 
Trigger cable 

Outputs a LOW level signal 
from the ICD to the Event 
Trigger probe when an 
event point is passed during 
emulation. 

The Event Trigger output is 
useful when a timing analysis 
of some external circuitry 
(not controlled by the ICD) 
is desired. In this application, 
the LOW level signal could 
be used to trigger a logic 
analyzer or oscilloscope. 

Map 

Control 

YELLOW 

RED wire of 
the External 
Break cable 

Accepts a LOW level input 
signal from the target 
system to dynamically 
select between ROM and 
RAM. A LOW level input 
signal causes the ICD to set 
all memory as user (target) 
memory. 

The ROM/RAM selection 
process is helpful when 
developing a system which 
uses phantom ROM (ROM 
that operates for the system 
bootstrap procedure and 
then hides behind the main 
memory). The Map Control 
signal lets you access the 
same user memory address 
space that is occupied by the 
phantom ROM. 

External 

Break 

RED 

RED wire of 
the External 
Break cable 

Accepts a LOW level input 
signal from an external 
component to trigger a 
break during the program 
execution. 

The External Break input is 
useful in capturing information 
(usually on the hardware 
level) that exists outside of the 
control of the microprocessor. 
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Data Bus Emulation 
Connector 

Description The Data Bus Emulation Connector is an eight-pin socket con- 
nector with eight plug-in leads on the end of the connector. 

location Plugs into the DB.EMUL connector on the side of the ICD. (See 
"The Controls And Component Functions Of Your ICD”) 

Function The Data Bus Emulation Connector is used to forcibly output a 
RETI instruction (from the ICD) to Z80 peripheral chips (PIO, 
CTC, SIO, etc.). 

Application The Z80 uses a Bi-directional Bus Transceiver which is 
capable of transmitting and receiving signals through the 
same lines. If this data bus buffer is not pointed in the proper 
direction after an interrupt instruction, the Z80 peripheral 
chips will not recognize the RETI instruction. The easiest way 
to correct this problem is to bypass the data bus buffer and 
forcibly output the RETI instruction directly to the Z80 peri- 
pheral chips. 


ICD 278/Z80 TARGET SYSTEM 
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Using The Data Bus 
Emulation Connector 


Connect the Data Bus Emulation Connector (socket side) to the 
pin connector labeled “DB.EMUI1’ on the end-panel of the ICD. 
Connect the eight leads directly to the dip-clip (included with 
the ICD) and then to the buffered data bus. 


1 2 3 4 5 6 7 8 



DO 

D1 

D2 

D3 

D4 

D5 

D6 

D7 
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Emulation Select Switch 
Description 
Location 

Function 

Application 

Using The Emulation 
Select Switch 

ON 

OFF 


ON 

OFF 


ON 

OFF 


The Emulation Select Switch is a 4-bit, ON/OFF type switch. 

The E.M.SEL Switch end of the ICD. (See "The Controls And 
Component Functions Of Your ICD.") 

The Emulation Select Switch disables the ICD's data bus from 
the target system’s data bus (Bit 1), sends or suppresses the RD 
signal (Bits 2 & 3), and inserts 1, 2, or 3 wait states into the ma- 
chine cycle (Bit 4). 

See the individual bit settings that follow. 

Set the bits to the ON or OFF position with a small, pointed 
tool, 





u 

1 

2 

Be 

3 4 


ON - AUTO 2 CLOCK WAIT 
Qppj- RD INHIBIT BY MAPPING 
OFF - DO - 7 CUTOFF BY MAPPING 


OFF - NORMAL 

normal 

ON — NORMAL 



NOTE; FAaORY BIT SEHINGS 



NOTE: DO NOT SET BITS 2 & 3 TO THE "ON" POSITION AT 
THE SAME TIME. 
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ON 

OFF 


limi 

12 3 4 


Bit ONE 


OFF— Disables the ICD's data bus (pins D0-D7) from the target system's data bus. 
ON— D0-D7 output to the target system from the ICD's data bus (Normal setting). 



ICD 
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ON 

OFF 


fnni 

12 3 4 


Bit TWO 


ON 

OFF 


ilBI 

12 3 4 


Bit THREE 


2 ON Outputs the RD signal to the target system Independently of the Mapping 

3 OFF command [Normal setting]. 

2 OFF RD signal does not output to the target system when executing out of the ICD 

3 ON memory. Used in the in-circuit mode II only. 



ICD MEMORY 










LS244 

D^_ 

RD 






Z80 




#2 ‘ 




I/O DEVICES 



RD 

— ► 













LS244 















MEMORY 










TARGET SYSTEM 
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ON A 1, 2, or 3 clock wait Is inserted In each machine cycle. 

OFF No clock wait is inserted in machine cycle. 

The wait state produced by the ICD-278 can hold for a period of two (optional 
one or three) clocks (wait states) by connecting the WT, 1C and 20 points on 
the S-793 CPU module. 

Setting the wait state: 



1 clock cycle wait 


2 clock cycle wait 


3 clock cycle wait 



o 

1C 



o o o 

1C WT 2C 


(Factory Setting) 
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SECTION 2 — MASTER COMMAND GUIDE 
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2-20 Event then Hardware Breakpoint 

2-21 ARM Initialize 

2-23 Software Breakpoint Specification 

2-25 Software Breakpoint Recognition 

2-26 Software/User Breakpoint Code 

2-27 Software Breakpoint Qualification 

2-29 External Signal Qualification 

2-30 External Breakpoint Qualification 

2-32 Event Breakpoint 

2-33 Event Breakpoint Passcount 

2-34 Write Protect Breakpoint 

2-36 Timeout Breakpoint 

2-37 COMPARE Command 

2-38 DISASSEMBLE Command 

2-39 DUMP Command 

2-40 EVENT Commands 
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2-47 FILL Command 

2-48 GO Command 
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2-70 
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2-72 
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2-73 
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2-73 
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2-74 
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2-76 

MAP Commands 

2-76 

Status 
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ICD COMMANDS 
Program Control 


Memory Control 


GO— Starts the program execution 

BREAK— Stops the program execution on a variety of different 
parameters 

EVENT— Signals an event in the program, triggers the trace 
feature, or sends out an external signal at a point in the 
program 

HISTORY— Records the program execution in real time, and 
then displays it in either machine or disassembled format 

TRAGE— Displays program execution in non-real time 

NEXT— Displays “n" instruction lines as executed in non-real 
time 

OFFSET— Sets an offset in the emulator for relative program 
addressing 

ASSEMBLE— Gonverts the mnemonics entered from the key- 
board to machine language in memory 

DISASSEMBLE— Converts the memory contents to assembly 
language mnemonics 

DUMP— Displays the memory contents in hexadecimal/ ASCII 
format 

COMPARE— Compares the memory contents and displays 
the non-matching data 

MOVE— Moves the memory contents between the ICD and 
the target system 

EXAMINE— Examines and changes the memory contents 
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FILL— Fills the memory contents with data 

SEARCH— Searches the memory contents for either matched 
or unmatched data 

Debug/ REGISTER— Displays or changes the registers’ data 

Emulation Control 

SUPERVISOR— A "system call" to allow access to the serial 
input/output ports 

PRINT— Sends the display to a printer 

PIN— Enables or disables selected input signals 

PORT— Examines one or more I/O port locations and option- 
ally modifies them 

IDENTIFICATION— Identifies the type of emulator in use and 
the firmware version 

IN-CIRCUIT— Sets the ICD mapping mode 

USER— Allows one terminal to communicate with both the ICD 
and a host computer 

MAP— Sets the ICD/target system memory map 

Host & File LOAD— Loads an Intel Hex file from the host computer to the 

Handling Commands ICD memory 

SAVE— Saves an Intel Hex file to the host computer 

VERIFY— Checks a file in the host computer against a file in 
the ICD 

fHOST- Initiates or terminates LOCAL "Host Computer As- 
sisted" mode 

tQUIT— Exits ZICE control and returns control to the host 
computer operating system 

t Available with ZICE software only. 
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Introduction ZAX ICD-series emulators respond to commands which you 
enter from a console terminal or host computer. The com- 
mands enable the ICD to perform a variety of complex debug- 
ging tasks for you. In this section, you’ll learn how to use the 
debugger commands and how to perform actual debugging 
and development operations. 

In order to use the commands effectively, you'll need to be- 
come familiar with three different areas: 

■ The language needed to implement the commands 

■ What each command does 

■ How to use the commands to perform debugging or devel- 
opment operations 

Command Language All ZAX ICD-series emulators execute operations in response 

to “command statements” made up of the "command name” 
and “parameters.” The command name refers to a symbol or 
group of symbols that designate the basic emulation operation 
to be performed (e.g., G for GO, MA for MAP, T for TRACE, 
etc.). Parameters refer to any additional information that com- 
plements the command name, such as a specific address, an 
address range, or a base value. Together, the command name 
and the parameters can be combined to execute a variety of 
complex debugging operations. 

The control firmware within the ICD requires that the com- 
mand statements be entered in a concise and logical manner, 
and that all required elements of the command statement be 
used. The elements of the command statement are described 
on the next page. The elements shown there represent all 
possible items within a command statement. Of course, not all 
commands require the presence or absence of each element. 
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Elements Within A The Prompt Character. The prompt character lets you know 
Command Statement that the ICD is ready to accept a command statement. The 

prompt character is supplied by the ICD— you do not enter 
it— and it is always displayed on the left side of the console's 
screen. 

Excunple of prompt character: > 

The Commeind Neime. Commands are represented by the 
first, or first two, letters of the command name. The commands 
are displayed by upper-case typeface and should be entered 
using capital letters. 

Examples of command names: B (for BREAK), CO (for 
COMPARE), SA (for SAVE) 

Command Qualifiers. The slash key (/) acts to signal a qual- 
ifier for the command whenever it appears immediately fol- 
lowing the command mnemonic. 

Excimples of qualifiers: B/0 B/E F/W 

The Space Character. The space character is an invisible 
character that not only improves the readability of a sentence, 
but in the case of the command format, it is recognized as a 
delimiter for the command name. Spaces must be interpreted 
from the command format; there is no symbol used to indicate 
spacing. 

Example of space character in use: EV ON 

In this example, the space between EV and ON allows the 
ICD to interpret EV as the EVENT command, and ON as 
a directive to enable the command. 
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Keywords are items which you must enter as shown. These 
items are displayed by upper-case typeface, but usually any 
combination of upper-case or lower-case letters may be used 
to enter them. 

NOTE: Some terminals must use uppercase letters only. If the 
ICD responds with an error message, try using uppercase 
letters. 

Examples of keywords: UP EN LO ON OFF 

User-Supplied Items. Lower-case letters in italic typeface 
show items which you must supply; these are called user- 
supplied items. 

Examples of user-supplied items include the name of 
your file (TEST. HEX), a beginning address (0), an ending 
address (3FF), a comparison address (100), and data (55). 

Address and Data Parameters. The command numerical para- 
meters for the ICD commands are described below, 

addr, beg ^addr, comp addr, mov addr, stop ^addr, 

secirch addr = hexadecimal numbers in 16 bits (0-FFFF). 

These parameters specify a memory address with 16-bit hexa- 
decimal characters. These parameters can be specified in an 
addition or subtraction equation, or a bias can be added if off- 
set registers (0, 1, 2, or 3) are provided. 
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"Don’t care" conditions may be specified for the BREAK and 
EVENT commands, on a bit or nibble basis, by entering "X" 
at the desired position. Examples include: 

1A3X— Don’t care condition in hexadecimal notation. 
May be specified in 4-bit units (0-F, or X). 

lOlX X1XX_010X^1XX0— Don’t care condition in bi- 

nary notation. May be specified in 1-bit units (0, 1, or X). 

end ^addr = hexadecimal numbers in 16 bits (0-FFFF), or 

number of bytes in 16 bits (0-FFFF). 

NOTE: The byte format is; Lnnnn where nnnn = (0-FFFF). 

data, mod ^data, and search data = hexadecimal/binary 

number in 8/16 bits (0-FFFF). These parameters can be 
specified in an addition or subtraction equation, but the offset 
registers cannot be used. 

"Don't care" conditions may be specified for the EVENT com- 
mand, on a bit or nibble basis, by entering "X" at the desired 
position. Examples include: 

7X— Don’t care condition in hexadecimal notation. May 
be specified in 4-bit units (0-F, or X). 

OlXX-XOOl— Don’t care condition in binary notation. May 
be specified in 1-bit units (0, 1, or X). 
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The Equal Sign. The equal sign ( = ) causes the value or infor- 
mation on its right to assume a relationship with the value on its 
left. 


Example of the equal sign: P 100 = 55 

In this example, the ICD does not display anything in re- 
sponse to this entry, but the value entered on the right 
(which represents a data value of 55H) is now assigned a 
relationship with the value on the left (an address value of 
lOOH). 

The Comma Character. The comma character (,) is used to 
separate parameters when more than one parameter is re- 
quired to form a command statement. 

Example of the comma character: DI 0,100 

NOTE: A space may be substituted for a comma (eg., DI 0,100 
= Dl 0 100), but a space cannot be used where a comma acts 
as separator (eg., DI 0, 100). 

Brackets. Items in square brackets ([]) are optional. If you 
choose to include the information, you should not enter the 
brackets, only the information inside the brackets. 

Examples of brackets: \p = dafa] [,bias] 

The Return Key. The return key is used to terminate state- 
ments and execute commands, and it must be entered after 
every statement. It is assumed that the return key must be 
pressed after the command statement is entered; there is no 
symbol used to indicate the return key in the command format. 

NOTE: Other parameters are defined and explained in each 
command. See Terms and Notes for an explanation about 
these parameters. 
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Example Of The 
Command Format 


Command ® 
Operation ® 

Syntax 0 
Terms 0 

Syntax Example 0 
Notes © 

Command Example 0 


Each command is presented in the same format as shown 
below. This format makes it easy to find the name of a com- 
mand and what it does, and then how to enter it correctly. An 
example (sometimes more than one) shows how the command 
is used in a debug/ development session. 

The example below illustrates the DUMP command and in- 
cludes many elements of a typical command statement. This 
command is also used as the syntax example in ' 'How To Enter 
A Command.” 

DUMP 

Displays the memory contents in both hexadecimal and ASCII 
code. 

D[IW] beg_addr[,end^adclr] 

W = Displays the memory contents in word units arranged in 
MSB/LSB order (default is byte units). 

beg_addr = Beginning address of display. 

end addr = Ending address of display. 

D/W 100,1FF 
D 120 

The end addr is an optional parameter. If it is omitted, 16 

bytes are displayed starting with beg addr. 

See Syntax Example above. The first . . . 
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0 Command. The command name is always found at the top 
of the page. If a command performs more than one task, a 
description of the various command functions can be found 
after the command name, for example, “OFFSET: Specifica- 
tion" and "OFFSET: Status." 

© Operation describes the action of the command, and 
emulation practices and principles that involve the command. 

® Syntax shows the characters and elements that are need- 
ed to implement the command. However, the characters and 
elements in Syntax may not provide enough information in 
themselves to correctly enter the command (the parameters 
may only represent an address or data value). The information 
in Terms should then be used to define the parameters. 

® Terms describes the characters and elements used in 
Syntax. The lower-case characters in Italic typeface show 
items which you must supply. Upper-case characters show 
what these items are and how they should be entered. 

© Syntax Example shows how the command might be en- 
tered using various characters and elements, and the correct 
spacing between them. 

NOTE: If a command cannot be entered, or the ICD responds 
with an error message, try entering the example shown in Syn- 
tax Example. 

© Notes explains important facts about the command. It 
usually contains information about the parameters shown in 
Terms, or it may include an explanation of how the command 
is used in a debug/development application. Spacing des- 
cribes the correct spacing of the elements of the syntax. 

© Command Example shows how the command might be 
used in an actual debug/development session. 
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How To Enter Before you can enter a command, you'll need to know what 

A Command operation(s) the command performs. This information can be 
found in two different places: "ICD COMMANDS” and “HOST 
& FILE HANDLING COMMANDS,” which is shown on the first 
few pages of this section, and Operation, found in "Example Of 
The Command Format.” 

After selecting the command, examine the information in Syn- 
tax and Terms. Enter the parameters needed to perform the 
task you desire. Examine the Syntax Example to see the 
proper spacing and how the characters and elements are 
used. An example of this procedure is shown below using the 
DUMP command. 

Command Example The syntax for the DUMP command is: 

D[/W] beg_adclrl,encl_adclr] 

The terms used in the syntax are: 

W = Display the memory contents in word units (default 
is byte units). 

beg addr = Beginning address of display. 

end_addr = Ending address of display. 
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Entering The To use this command, first enter D (the mnemonic for DUMP). 
Command Example Now decide (after examining the definitions in Terms) if the 

memory contents should be displayed in word or byte units. 
Since W is in brackets, it represents an optional parameter (if 
it was omitted, the display would be in byte units). For this 
example, we’ll use a word display and enter W, preceded by 
a slash, and followed by a space. The first user-supplied item 
is the beginning address for the display (we’ll supply the value 
of 100). The next item is an optional (because it’s in brackets, 
[ ]) ending address. In this example we’ll specify IFF for this 
parameter, preceded by a comma (,). 

At this point, the display on the console’s screen should look 
like: 

>D/W 100, IFF 

This input now forms a command statement, complete with the 
command mnemonic, usable parameters, elements, and pro- 
per spacing. To send the command statement to the ICD for 
execution, press the return key on your keyboard. 

What To Do If You If you make an error when entering a command statement. 
Make An Input Error merely backspace over the error (which cancels the char- 
acter) and enter the new information. You can also press the 
Delete (Del) key, which not only cancels out the error, but 
displays the cancelled character as well.* 

If you've already entered a command statement into the ICD 
but you meant something else, press Ctrl-U (Control-U),* then 
just re-enter the correct command statement, and the ICD will 
execute the latest command. 

*NOTE: These features are available in the LOCAL mode only 
(i.e., when a console terminal is used to control the ICD 
directly). 
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Error Messages 

If you enter a parameter incorrectly, use an invalid address, 
or forget to use a space at the appropriate place, the ICD will 
respond with an error message. The error messages and 
causes are shown below and on the back of the fold-out Com- 
mand Reference Guide. 

Error Message 


Displayed when 

C?> 


an unrecognizable command is entered 

P?> 


a parameter code error occurs 

/?> 


a modifier code error occurs 

* ’Break Busy 


the break specification exceeds the limit 

* * Unable Soft Break 


a software break is set at the address presently not 
mapped in RAM 

•’Multi Break Address 


a software break is set at the same address 

’ ’ Input Error 


an input error occurs 

’’Check Sum Error 


a check sum error occurs 

’’File Name Error 


a parameter code error occurs with the LOAD or 

VERIFY commands 

’ ’ Not Local Mode 


a LOCAL mode command is used when the system 
is in the REMOTE mode 

’ ’ Not Remote Mode 


a REMOTE mode command is used when the 
system is in the LOCAL mode 

’ ’ Memory Write Error at **** 

there is a memory modification error 

’ ’ I/O Timeout Error at **** 

a timeout error occurs at a specific address 

’ ’ Memory Timeout Error 
at #### 

memory or I/O in the target system does not 
respond to an ICD access 

’ ’ Memory Guarded Access 
Error ^\#*** 

when a user program attempts to access an area 
mapped as NO memory 

’ ’Software Break Instruction 
Misrecovered at **** 

an error has occurred while attempting to replace 
original contents of a software break location 

NOTE: #s refer to address locations in the program. 
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Command 

Operation 


Syntax 

Terms 


Syntax Example 


ASSEMBLE 


ASSEMBLE 

Translates simple-to-understand mnemonic instructions into 
machine language. The opposite translation (machine lan- 
guage to assembly language mnemonics) is accomplished 
using the DISASSEMBLE command. 

Applications Note: The In-Line Assembler in the ICD is a 
powerful software tool that can be used for writing patches into 
program code that has either been downloaded from a host 
computer or originated in the target system. This feature also 
lets you quickly write your own routines, develop small pro- 
grams, write hardware/software test routines, etc. 

A mem_ocfcfr < cr > 

xxxx (Z80 assem bly code) < cr > 

xxxx <cr> 

mem addr = The beginning memory address where 

assembled code is stored. 

xxxx = The current storage location. 

Z80 assembly code = The mnemonic instruction to be 
assembled and stored. 

<cr> = Exits the assemble mode. 

>A 100 
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ASSEMBLE 

Notes 


Command Example 


The ICD will not accommodate the keyboard entry: EX AF,AF' 
(AF prime) as would normally be entered by a programmer. 
Instead, enter EX AF,AF (non-prime). The ICD interprets this 
correctly and will display EX AF,AF' on disassembly. 

All number operands are assumed to be decimal unless spec- 
ified as hexadecimal. 

Spacing: A space is required between A and mem_addr. 
A space is required between opcode and operand of mne- 
monic instruction (no tab). 

Execute this sequence: 

> A 1 00 ■«- STARTS ASSEMBUNG THE PROGRAM INTO ADDRESS 1 0OH 

0100 LD HL,0A000H 

0103 PUSH DE 

0104 LD DE.OBOOOH 

0107 EX DE,HL 

0108 POP DE 

0109 INC HL 
010A INC DE 
01 OB JP 5000H 

0 1 0E <- PRESS THE RETURN KEY HERE TO END THE PROGRAM INPUT 

> 

> Dl 1 00,1 1 0 DISPLAYS THE PROGRAM JUST ENTERED 
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Command BREAK 

Introduction The best way to safely stop a moving car is by using the 
brakes. In emulation, the best way to stop a program for exam- 
ination is by using BREAKpoints. You can use the BREAK com- 
mands to set breakpoints anywhere within a program, and you 
can specify many different types of breaks to stop the pro- 
gram execution. Breakpoints differ from event points (see the 
EVENT command) in that they actually cause the program to 
stop execution, whereas event points are used to trigger var- 
ious external events, including stopping execution, but without 
necessarily affecting the emulation process. 

Software breakpoints replace program instructions automat- 
ically with monitor calls, in order to stop the program execu- 
tion at a particular point in the program. This provides real- 
time operation until the break. Several software breakpoints 
can be set throughout the program and selectively enabled 
and disabled. Also, an unlimited number of user breakpoints 
can be assembled into the code throughout the program. 

The IGD can also implement hardware breakpoints, which 
recognize machine cycles but do not disturb normal software 
execution. Hardware breakpoints can cause the ICD hard- 
ware to monitor the address and status signals for a specified 
condition. When the conditions are met, a break occurs. 

Both hardware and software breakpoints can be activated 
(enabled), and then temporarily deactivated (disabled), with- 
out affecting their location addresses within the program or 
their parameter specifications. 

Another break feature allows the ICD to use a probe to 
receive a signal from a peripheral, which can then cause a 
break in the program. (See "More About Your ICD," in 
Section 1 . Read about how to use the accessory cables and 
probes.) 

There are 15 different BREAK command formats. See each 
format for an explanation and an example. 
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Command BREAK: Status 

Operation Displays the current status of the break command. Use this 
command to check the condition of the breakpoint settings. 


Syntax 
Command Example 


B 

>B 

A (ONJ OF 0022 1 

B (ON) MW 2000 1 

C (ON) OF 0100 1 

E 
T 
S 


0 IND (0000_0000_0010_0010) 
0 IND (0010_0000_0000_0000) 


(OFF) 
(ON) 
(EN) 
W (ON) 

i i 


HALT (76H) 


0 IN 


D (0000_0001_0000_0000) 


BIT-WISE PHYSICAL ADDRESS 

independent of or ARMed by event 

ElAPSED COUNT 
PASS COUNT 
ADDRESS 

BREAK OPERATION 
BREAK STATUS 
BREAK IDENTIFICATION 


NOTE: A,B,C = hardware break names, E = event break, 
T = ready timeout break, S = software break opcode, W = 
write-protect break. 
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BREAK 

Command 

BREAK: Hardware Breakpoint Qualification 

Operation 

Enables, disables, or clears the setting of the hardware break- 
points. 


Applications Note: This command can be used to temporarily 
disable hardware breakpoints (set by the "BREAK: Hardware 
Breakpoint” command) without affecting their locations within 
the program or their parameter specifications. 

Syntax 

B[/nome] switch 

Terms 

name = A, B, or C 


switch = ON. OFF. or CLR 

Syntax Example 

B/AON 

BOFF 

Notes 

A, B, or C identifies hardware breakpoint names, and more 
than one name can be specified at a time (e.g., B/A/C CLR). If 
the breakpoint name is omitted, all hardware and software 
breakpoints are affected. 


ON enables the breakpoint(s), OFF disables the breakpoint(s), 
and CLR clears the break condition. 


Spacing: A space is required between name and switch. If 
name is omitted, a space is required between B and switch. 

Command Example 

See Syntax Example above, and the "BREAK: Hardware 
Breakpoint Specification” command. 
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BREAK 

Command BREAK: Hardware Breakpoint Specification 

Operation Sets a hardware breakpoint within the user program. Setting a 

hardware break configures the emulator hardware to monitor 
the address and status signals for the specified condition to 
occur. When the conditions are met in the program, a break 
occurs. 

Syntax B[/nome] status, addrlpasscount] 

Terms name = A, B, or C 

status = Any one of eight types of break status, including: 

M (memory access) 

P (port access) 

MR (memory read) 

MW (memory write) 

PR (port read) 

PW (port write) 

OF (operation code fetch) 
lA (interrupt acknowledge) 

addr = The address to break on. 

passcount = The number of times the condition occurs before 
breaking, from 1 to 65535. 

Syntax Example B/C M,000X_111X_XXXX_0000 

Notes A, B, or C identifies hardware breakpoint names. 

If the name is omitted, the next available breakpoint is used. 

With this command, addr can be specified by a binary or 
hexadecimal notation. To specify a "don't care" condition in 
1-bit units (binary notation), or in 4-bit units (hexadecimal nota- 
tion), write X at the required position. 
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Command Example 


BREAK 

If passcount is specified, real-time operation is momentarily 
lost each time the condition occurs. If the passcount specifica- 
tion is omitted, 1 is assumed. 

Spacing; A space is required between name and status. If 
name is omitted, a space is required between B and status. No 
spaces are permitted where commas are used as separators. 

Execute this sequence: 

>B/B OF,200 <- SPECIFIES HARDWARE BREAKPOINT 

> B <- CHECKS BREAKPOINT STATUS 

B (ON) OF 0200 1 0 IND (0000_0010_0000_0000) 

E (OFF) 

T (ON) 

S (Dl) LD A,A(7FH) 

W (ON) 

> B/B OFF «- DISABLES HARDWARE BREAKPOINT B 

> B «- CHECKS THE BREAKPOINT STATUS AGAIN 

B (OFF) OF 0200 1 0 IND (0000_0010_0000_0000) 

E (OFF) 

T (ON) 

S (Dl) LDA,A(7FH) 

W (ON) 

This example shows a hardware breakpoint is placed at ad- 
dress 200 in the program and that the status to break on is an 
op code fetch. The "BREAK: Status" command is then used to 
verify the breakpoint setting. Next, the breakpoint is tempor- 
arily disabled using the B/B OFF command. Again, the 
"BREAK: Status” command is used to show that the change has 
been made. 
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BREAK 


Command 

BREAK: Event then Hardware Breakpoint 

Operation 

Causes a break in the program at a hardware breakpoint (A, B, 
and C), but only after an event point is also passed (see EVENT 
command). The arm feature creates a simple level of sequen- 
cing: A then B relationship. 


Applications Note: This command can be used to trigger a 
peripheral device (such as a logic analyzer) when an event 
point is passed in the program, and then to stop the program at 
the breakpoint. 

Syntax 

B[/nome] switch 

Terms 

name = A, B, or C 


switch = ARM or IND 

Syntax Example 

B/C ARM 

B IND 

Notes 

A, B, or C identifies hardware breakpoint names, and more 
than one name can be specified (e.g., B/A/C IND). If the break- 
point name is omitted, all three hardware breakpoints are 
affected. 


If ARM is selected, the break occurs after an event trigger 
takes place. If IND is selected, the break occurs independently 
of any event trigger. 


The ARMing event is not automatically reset. See the "BREAK: 

ARM Initialize” command. 


Spacing: A space is required between name and status. If 
name is omitted, a space is required between B and status. 

Command Example 

See Syntax Example above. 


2-20 ZAX Corporation ICD-278 for Z80 


Section 2 


MASTER COMMAND GUIDE 



BREAK 


Command 

BREAK: ARM Initialize 


Operation 

Clears (initializes) the event pass condition and resets the ARM 
specification of the “BREAK: Event then Hardware Break- 
point" command. 


Syntax 

B INI 


Notes 

Spacing: A space is required betweeen B and INI. 



Once the ARMing event has occurred, the condition will 
remain ARMed until cleared by this command. 

Command Example 

Execute this sequence: 



>A 100 <- ASSEMBLE PROGRAM WITH NESTED LOOPS THAT PERFORM 

0100 LD HLIOOOH periodic writes to memory of decrementing data 

0103 LD BCO 

0106 DJNZ $ 

0108 DEC C 

0109 LD (HL)C 

01 OA JR NZ,-5 

010C 

>B/A OR106 <- BEGIN EXECUTION 

> G 1 00 <- SET BREAKPOINT FOR EXECUTION OF INNER LOOP 

PC MC 
0106 10FE 

OP SP AF BC DE HL IX lY 1 IF (SP) 

QJNZS 0000 0000 FFOO 0000 1000 0000 0000 00 0 FCFF 

< Break Hardware A > <- break occurs immediately 

>EV ST=MW,A=10XX,D=33 <- set event to occur after c register 

>-B/A ARM HAS BEEN DECREMENTED T0 33H,AND 

D ARM THE BREAKPOINT WITH EVENT 

>B 

A (ON) OF 0106 1 0 ARM (0000_0001_0000_0110) 

E (OFF) 1 0 

T (ON) 

S (Dl) LDA,A(7FH) 

W (ON) 

>G 100 <- BEGIN EXECUTION 
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PC MC OP SP AF BC DE HL IX lY I IF (SP] 

0106 10FE DJNZ$ 0000 0022 FF33 0000 1000 0000 0000 00 0 FCFF 

< Break Flardware A > ■<- notice c register has been decremented to ssh 

>B 

Event Done <- shows event has occurred 

A (ON) OF 0106 1 0 ARM (0000_0001_0000_0110) 

E (OFF) 1 0 

T (ON) 

S (Dl) LD A,A(7FH) 

W (ON) 

> G 1 00 ■>- BEGIN EXECUTION AGAIN 


PC MC 
0106 10FE 


IX lY I IF (SP) 
0000 0000 00 0 FCFF 

ARM CONDITION STILL IN EFFEa FROM PREVIOUS EXECUTION 
SO BREAK OCCURS IMMEDIATELY 


BC 

FFOO 


DE 

0000 


HL 

1000 


OP SP AF 

DJNZ $ 0000 0022 

< Break Hardware A> 

>B INI 

> B <- INITIALIZE THE ARM CONDITION, AND NOTICE THE CONDITION REMOVED 


(ON) 
(OFF) 
(ON) 
(Dl) 

W (ON) 
>G 100 


OF 0106 


LD A,A(7FH) 


0 ARM (0000. 
0 


_0001_0000_0110) 


■ BEGIN EXECUTION AGAIN 


PC MC 
0106 10FE 

< Break Hardware A > 
> 


OP SP AF BC DE HL IX lY I IF (SP) 

DJNZS 0000 0022 FF33 0000 1000 0000 0000 00 0 FCFF 

<- AGAIN, BREAK WAITS FOR EVENT ARM CONDITION 
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Command 

Operation 


Syntax 

Terms 

Syntax Example 

Notes 


BREAK 


BREAK: Software Breakpoint Specification 

Sets a software breakpoint within the user program. 

Setting a software breakpoint causes the ICD to automatically 
replace the opcode at the specified address with an LD A,A or 
a HALT instruction opcode (see the "BREAK: Software/User 
Breakpoint Code" command). When this code is encountered 
during execution, a temporary break will occur, the original 
contents of this location will be replaced, and execution will 
restart at that same location for the duration of that one instruc- 
tion. The ICD will then enter the monitor code. 

Q[lname] addr[,passcounf\ 


name = 0, 1, 2, 3, 4, 5, 6, or 7 


addr = The address to break on. 

passcount = The number of occurrences before a break, 
from 1 to 65535. 

B/4 100,3 
B/7 1000 

0, 1, 2, ... or 7 identifies software breakpoint names. 

If the name is omitted, the next available breakpoint is used. 

With this command, addr can be specified by binary or hexa- 
decimal notation. To specify a "don’t care" condition in 1-bit 
units (binary notation), or in 4-bit units (hexadecimal notation), 
write X at the required position. 

If passcount is specified, real-time operation is momentarily 
lost each time the condition occurs. If the passcount specifica- 
tion is omitted, 1 is assumed. 
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A software breakpoint is not allowed to be specified in a USER- 
ROM area since a software breakpoint requires changing the 
memory contents at the specified location to an LD A,A or HALT 
instruction, and ROM cannot be changed. A hardware break- 
point must be used in this situation. 


A software breakpoint must be specified for a location contain- 
ing the first byte of an opcode, otherwise the ICD will not 
break, and unpredictable results will occur within the pro- 
gram execution. 


Spacing: A space is required between name and addr. If 
name is omitted, a space is required between B and addr. 

Command Example Execute this sequence: 


>B/5 1000 SETS SOFTWARE BREAKPOINT AT ADDR 1000 

>B S=EN <- ENABLES THE SOFTWARE BREAKPOINTS 


> B ♦- CHECKS THE STATUS OF THE BREAKPOINTS 


5 (ON) 1000 
E (OFF) 

T (ON) 

S (EN) LD A,A(7FH) 
W (ON) 


0 <- SHOWS THAT SOFTWARE 

A BREAKPOINT <*5 IS 

' ACnVE AT ADDR 1000 


> 


This example shows that a software breakpoint labeled 5 is set 
at address 1000 in the program. The software breakpoint is 
enabled (software breakpoints must be enabled to function), 
and then the "BREAK: Status" command is used to show that 
the change has been made. 
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BREAK 

BREAK: Software Breakpoint Recognition 

Operation 

Enables or disables all software and user breakpoints. Setting 
a software breakpoint is a two-step operation requiring the 
software and user breakpoint to be enabled before any soft- 
ware breakpoints become operational. 

Syntax 

B S= switch 

Terms 

swltch=EN or Dl 

Syntax Example 

B S = EN 

Notes 

EN enables the software and user breakpoints, causing a 
break in the program based on the software breakpoint 
specification, or when a user break is encountered. Dl 
disables the software and user breakpoints, causing them to 
be temporarily disabled, although their initial specification re- 
mains unaffected. 


The ICD defaults to Dl upon power-up or reset. 


Spacing: A space is required between B and S. No spaces are 
permitted after S; the equal sign ( = ) acts as the separator. 

Command Example 

See Syntax Example above, and the "BREAK: Software Break- 
point Specification” command. 
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Command BREAK: Software/User Breakpoint Code 


Operation Specifies which code the ICD uses to implement a software or 
user break. The ICD can use either HALT (76H) or LD A,A (7FH) 
to cause a software break within the user program. Either 
code may be selected by the user to conveniently cause a 
break in the program without having to continuously specify 
the breakpoint parameters. 

Syntax B S=op_coafe 


Terms op_coc/e = HALT or LD A,A 


Syntax Example B S=HALT 


Notes The ICD defaults to LD A,A upon power-up or reset. 


Spacing: A space is required between B and S. No spaces are 
permitted after S; the equal sign ( = ) acts as the separator. 

Command Example Execute this sequence: 


> B <- CHECKS THE BREAKPOINT STATUS 

E (OFF) 1 0 

T (ON) 

S (Dl) LD A,A(7FH) «- shows software break code 

^ is CURRENTLY LD A,A 

>B S = HALT «- CHANGES SOFTWARE BREAK CODE TO HALT 
>B S = EN <- enables ALL SOFTWARE BREAKPOINTS 

> B <- CHECKS THE BREAKPOINT STATUS AGAIN 

E (OFF) 1 0 

T (ON) 

S (EN) HALT(76H) shows the software break 

\A/ rOMI CODE IS NOW HALT 


This example shows how the software break code is changed 
from LD A, A to HALT and then enabled. The "BREAK: Status" 
command shows that the change has been made. 
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Command 

Operation 


Syntax 

Terms 

Syntax Example 

Notes 


BREAK 


BREAK: Software Breakpoint Qualification 

Enables, disables, or clears the software breakpoints. 

Applications Note: This command can be used to temporarily 
disable software breakpoints (or all the breakpoints) without 
affecting their address locations within the program, or their 
parameter specifications. 

B[/nome] switch 


name = 0, 1, 2, 3, 4, 5, 6, or 7 


switch = ON, OFF, or CLR 

B/3 ON 
B OFF 

0, 1, 2, ... or 7 identifies software breakpoint names, and 
more than one name can be specified at a time (e.g., B/1/2/3/4 
OFF). If the breakpoint name is omitted, all the hardware and 
software breakpoints are affected. 

ON enables the breakpoint, OFF disables the breakpoint, and 
CLR clears the break condition. 

Spacing: A space is required between name and switch. No 
spaces are permitted between B/nome. 
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Command Example Execute this sequence: 


> B <- CHECKS THE BREAKPOINT STATUS 

E (OFF) -I 0 

T (ON) 

S (Dl) LD A,A(7FH) 

W (ON) 

>B/2 7FF •'-SETS A SOFTWARE BREAKPOINT AT ADDR 7FF 

> B S = EN <- ENABLES THE SOFTWARE BREAKPOINTS 


> B •<- CHECKS THE BREAKPOINT STATUS AGAIN 


2 (ON) 07FF 1 
E (OFF) 1 

T (ON) 

S (EN) LD A,A(7FH) 

W (ON) 


0 SHOWS THE SOFTWARE 

0 BREAKPOINT IS ACTIVE 

ATADDR7FF 


> 

>B/2 OFF •<- DISABLES SOFTWARE BREAKPOINT '»2 


> B <- CHECKS THE STATUS AGAIN 

2 (OFF) 07FF 1 0 

E (OFF) 1 0 

T (ON) 

S (EN) LD A,A(7FH) 

W (ON) 


•<- SHOWS SOFTWARE 

BREAKPOINT *2 IS INACTIVE 


This command shows how a software breakpoint is set, enab- 
led, and then disabled. After each operation, the status of the 
breakpoints is checked against the changes. 
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BREAK 

BREAK: External Signal Qualification 

Operation 

Allows the ICD to sense a signal (using the accessory probes) 
from an external source and cause a break in the user pro- 
gram. This command specifies how the break is triggered; 
either from the high-going or low-going edge of the external 
signal. To enable or disable this command, see the "BREAK; 
External Breakpoint Qualification" command. 

Syntax 

B/X edgelpasscounf] 

Terms 

edge = HI or LO 


passcount = The number of occurrences before a break, 
from 1 to 65535 

Syntax Example 

B/X LO 

Notes 

HI causes the breakpoint to occur on the rising edge of the 
signal, LO causes the breakpoint to occur on the falling edge 
of the signal. 


When edge is specified, the External Breakpoint Qualification 
is always enabled. 


If passcount is specified, real-time operation is momentarily 
lost each time the condition occurs. If the passcount specifica- 
tion is omitted, 1 is assumed. 


Spacing: A space is required between B/X and edge. No 
spaces are permitted between B/X. 

Command Example 

See the "BREAK: External Breakpoint Qualification" com- 
mand. 
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Command 

BREAK: External Breakpoint Qualification 

Operation 

Allows the ICD to sense a signal (using the accessory probes) 
from an external source and trigger a break in the user pro- 
gram during emulation. This command enables, disables, or 
clears that feature. (For more information on how to use the 
accessory probes, see "More About Your ICD," in Section 1.) 

Syntax 

B/X switch 

Terms 

switch = ON, OFF, or CLR 

Syntax Example 

B/X CLR 

Notes 

ON enables the recognition of an external trigger, OFF 
disables the recognition of the external trigger, and CLR clears 
the external trigger specification. 


Spacing: A space is required between B/X and switch. No 
spaces are permitted between B/X, 

Command Example 

Execute this sequence: 


> B <- SHOWS THE BREAKPOINT STATUS 

E (OFF) 1 0 

T (ON) 

S (Dl) LD A,A(7FH) 

W (ON) 

> B/X HI <- SETS SIGNAL RECOGNITION TO HIGH EDGE OF SIGNAL 

>B 

X (ON) HI 10 •<- SHOWS EXTERNAL BREAK 

g (OFF) 1 0 FEATURE IS ACTIVE 

T (ON) 

S (Dl) LD A,A(7FH) 

W (ON) 

>B/X OFF <- disables EXTERNAL BREAK FEATURE 
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> B <- CHECKS BREAKPOINT STATUS AGAIN 

X (OFF] HI 1 0 <- SHOWS EXTERNAL BREAK 

g (OFF) 1 0 FEATURE IS INACTIVE 

T (ON) 

S (Dl) LD A,A(7FH) 

W (ON) 

>B/X CLR CLEARS THE EXTERNAL BREAKPOINT FEATURE 
>B 

E (OFF) 1 0 

T (ON) 

S (Dl) LD A,A(7FH) 

W (ON) 

This example shows how the external breakpoint specification 
is set to occur at the high edge of an external signal. The ex- 
ternal breakpoint is then disabled temporarily, and finally 
cleared. 
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Command 

Operation 

Syntax 
Terms 
Syntax Example 
Notes 


BREAK: Event Breakpoint 

Allows the ICD to use an event trigger as a breakpoint (see the 
EVENT command). This command enables or disables that 
feature. 

B/E switch 

switch = ON or OFF 
B/E OFF 

ON enables the event breakpoint and OFF disables the event 
breakpoint. 


Spacing: A space is required between B/E and switch. No 
spaces are permitted between B/E. 


2-32 


> E V •«- SHOWS EVENT STATUS 

Event is Clear shows absence of event points 
>EV ST=OF A=7FF «- sets an event point in program 

> E V <- SHOWS NEW event POINT SETTING 


(ON) 

Status = OF 

Address = 07FF 

Data = XX (XXXX_XXXX) 

>B/E ON <- MAKES THE EVENT POINT active IN PROGRAM 

>B 

E (ON) 1 0 <- SHOWS EVENT POINT SETTING 

T (ON) 

S (Dl) LD A,A(7FH) 

W (ON) 


This example shows how an event in the program can be used 
to send out a signal to a peripheral device. First, the event 
point is set in the program at address 7FF, and then the status 
command is used to verify the setting. Next, the event point is 
enabled by using a breakpoint command. The "BREAK: Stat- 
us" command is used again to verify that the event point is 
enabled (ON). 
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Command BREAK: Event Breakpoint Passcount 
Operation Sets the passcount for the event breakpoint. 

Syntax B/E passcount 

Terms passcount = The number of occurrences before a break, 
from 1 to 65535 (default =1). 

Syntax Example B/E 4 
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Command BREAK: Write Protect Breakpoint 


Operation Causes a break in the user program if the program attempts to 
write into a protected memory area (see the MAP command). 
After the break, the ICD responds with a message that reads: 
Break Write Protect. 

If this break is disabled, any attempt to write to a protected 
memory location will fail, thereby preserving its integrity; 
however, program execution will continue without causing a 
break. 


Syntax B/W switch 
Terms switch = ON or OFF 


Syntax Example 
Notes 


B/W ON 

ON enables the write protect feature and OFF disables the 
write protect feature. (TTie write protect feature is automatical- 
ly activated when the ICD boots up.) 


Spacing: A space is required between B/W and switch. No 
spaces are permitted between B/W. 
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Command Example Execute this sequence: 


>MA 0,FFF=RO 
>MA 

In-Circuit Mode 0 


<- SETS MEMORY AS READONLY 
FROM ADDRESS 0 TO FEE 

(US= >RW) 


OOOO-OFFF = RO <- shows status of memory is readonly 
1000-FFFF = RW fromaddrotoffff 

>BAA/ ON ■•-ENABLES THE WRITE protect FEATURE 

>B 

E (OFF) 1 0 

T (ON) 

S (Dl) LD A,A(7FH) 

W (ON) 


This example shows how the write protect feature might be 
used. First, memory within the ICD is mapped from 0 to FFF as 
read-only. Because the in-circuit status is I 0 (debugging using 
the ICD’s memory only), any area mapped as user (target 
system) memory is now remapped as read/write memory in 
the ICD. This causes all remaining memory areas to act as 
read/write memory. Next, the write protect feature is enabled 
(ON) using the “BREAK: Write Protect Breakpoint" command. 
Finally, the break status is checked to verify the changes. 


The ICD now causes a break if an attempt is made to write into 
memory locations 0 to FFF. 
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Command 

BREAK: Timeout Breakpoint 

Operation 

Causes a break in the user program when the ICD is unable to 
access the target memory contents within a certain time 
period. If the wait signal is activated for more than 128 clock 
cycles, a time-out condition will occur. After the break, the 

ICD responds with an error message that reads: Break Time- 
out. 


Applications Note: This break command can be used to flag 
an un-negated wait condition caused by the target system. 

This could be caused by a problem in the hardware, or it 
could be inherent in the design. If the problem lies in the 
design, this feature should be disabled. But if it is a hardware 
problem, disabling this feature could cause the ICD to ' 'lock- 
up" due to a continuously activated wait condition. 


This feature can also act as a safeguard for the target's refresh 
period if Dynamic RAMs are being used. 

Syntax 

B/T switch 

Terms 

switch = ON or OFF 

Syntax Example 

B/T OFF 

Notes 

ON enables the timeout feature and OFF disables the timeout 
feature. (The timeout feature is automatically activated when 
the ICD boots up.) 


Spacing: A space is required between B/T and switch. No 
spaces are permitted between B/T. 

Command Example 

See Syntax Example above. 
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Command 

Operation 

Syntax 

Terms 


Syntax Example 
Notes 


Command Example 


COMPARE 

COMPARE 

Compares the contents of specified memory blocks within the 
ICD or target system, and then displays the non-matching 
data. The comparison can be made between different 
memory blocks as mapped to the ICD, or between one block 
of memory within the ICD and one in the target system. 

CObeg^addr,end^adclr,comp_adclrl,dlrection] 

beg addr = The beginning address for comparison. 

end^addr = The ending address for comparison. 

comp addr = The beginning memory address to be 

compared. 

direction = UP or PU. 

CO 100.3FF,1000,UP 

If UP is selected, beg^addr is user memory, and comp__addr 
is ICD program memory. If PU is selected, beg_addr is ICD 
program memory and comp addr is user memory. 

If direction is omitted, memory locations are specified by the 
MAP command. 

This command displays non-matching data on a line-for-line 
basis. To control the scrolling of the display, alternately press 
the space bar. To exit the display, press the Escape (Esc) key. 

Spacing: A space is required between CO and beg addr. No 

spaces are permitted after beg_addr, commas are used to 
separate the remaining parameters. 

See Syntax Example above. This example shows that a 
memory block (100 to 3FF) in the target system is compared 
with a block of memory in the ICD, beginning at address 1 000. 
Any unmatching data will be displayed, along with the location 
addresses. 
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Command 

DISASSEMBLE 

Operation 

Translates the memory contents from machine language to 
assembly language mnemonics, and then displays the con- 
verted contents. The opposite translation (assembly language 
mnemonics to machine language) is accomplished by using 
the ASSEMBLE command. 

Syntax 

Dl [beg addr][,end_^addr] 

Terms 

beg-jaddr = The beginning memory address in the program. 


end__addr = The ending memory address in the program. 

Syntax Example 

Dl 100,200 

Dl 20 

Dl 

Dl ,L40 

Notes 

If beg_addr is omitted, disassembly begins at the current 
program counter (PC). If end__addr is omitted, 1 1 lines of in- 
structions are automatically displayed. 


This command displays items on a line-for-line basis. To con- 
trol the scrolling of the display, alternately press the space 
bar. To exit the display, press the Escape (Esc) key. 


Spacing: A space is required between Dl and beg_addr (if 
beg^addr is used). No spaces are permitted where a comma 
is used as the separator. 

Command Example 

See Syntax Example above. The first example shows that the 
memory contents in the ICD are disassembled beginning from 
address 100 to address 200. In the second example, the end- 
ing address is omitted, which causes the memory contents to 
be disassembled from address 20 to address 002B (11 lines). 

In the third example, 1 1 instruction lines are displayed from 
the current PC. In the fourth example, the display is from the 
current PC to PC + 3FH. 
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DUMP 

Command 

DUMP 

Operation 

Displays the memory contents in both hexadecimal and ASCII 
code. 

Syntax 

D[I\N] fc)eg_ocfdr[,enci_ocfafr] 

Terms 

W = Displays the memory contents in word units arranged in 
MSB/LSB (Most Significant Bit/Least Significant Bit) order. The 
default is byte unit display. 

beg_addr = Beginning address of display. 

end_addr = Ending address of display. 

Syntax Example 

D/W 100, IFF 

D 1FFF 

Notes 

The end_addr is an optional parameter. If it is omitted, 16 
bytes are displayed starting with beg addr. 

This command displays items on a line-for-line basis. To con- 
trol the scrolling of the display, alternately press the space 
bar. To exit the display, press the Escape (Esc) key. 

Spacing: A space is required between D or D/W and 
beg_^addr. No space is permitted where a comma is used as 
the separator. 

Command Example 

See Syntax Example above. The first example shows that the 
memory contents are displayed in word units, beginning with 
address 100 and ending with address IFF. The second exam- 
ple shows that the last 16 bytes are displayed beginning at 
address 1FFF. 
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Command EVENT 

Introduction An event can be defined as a significant occurrence in time. 

That is, events take their respected place at a point in time, 
without affecting the passing of time itself. And of course, the 
ICD's EVENT command works on the same principle. 

This command allows an event to occur during the execution 
of a program, without necessarily stopping the program. In this 
way, an event point differs from a breakpoint because break- 
points always stop the program execution. 

The EVENT command can enact four different operations. In 
one operation, the event point in the program can be used to 
externally trigger a peripheral device, such as a logic 
analyzer. The event point can also be used to internally trigger 
the real-time trace feature, which is defined by the HISTORY 
command. The event can also arm a hardware breakpoint in 
an A then B type sequence. And lastly, an event point can be 
used to stop the program in a manner similar to the BREAK 
command. The event, however, has the advantage of letting 
you specify a certain data pattern on the data bus, in addition 
to the normal address parameters, memory accesses, and I/O 
access conditions. 


The event can also be enabled and disabled, just like break- 
points. This feature allows you to temporarily disable the event 
setting without affecting its address location within the pro- 
gram or its parameter specifications. 

Using The To see how to use an event point as a breakpoint, first read 
EVENT Command about the EVENT command format here (for all four functions, 
the event point must be specified using the "EVENT: 
Specification" command), and then see the “BREAK: Event 
Breakpoint” command. To arm a hardware breakpoint, see 
"BREAK: Event Then Hardware Break" command. To use an 
event point to trigger the real-time trace, see the HISTORY 
command. To use an event point to trigger a peripheral 
device, see "More About Your ICD," in Section 1. Read the 
chapter on using the accessory cables and probes. 
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Command EVENT: Status 


Operation Displays the current event point settings. When changes are 
made to the event point setting by using the “EVENT: 
Specification” command, this command can be used to 
display the latest changes. 


Syntax EV 

Command Example >EV 

Event is Clear 


This is the default condition for the EVENT command. The 
display shows the absence of any event points in the program. 
After specifying an event point, the “EVENT: Status" com- 
mand might reveal: 

>EV 

(ON) «- SHOWS EVENT SETTING IS ACTIVE 
Status = PR «- PORT WRITE STATUS 

Address =34 (0010 0100) <- event at address 34 

Data =55 (0101 0101) •«- data value to match 

FOR event 

This status display shows that the EVENT command has been 
enabled (ON), that the status of the event point is port read (PR), 
that the port is located at address 34, and that the matching 
data value for the event point is 55. 
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Command EVENT: Qualification 

Operation Enables, disables, or clears an event trigger. 

Applications Note: This command can be used to temporarily 
disable an event point without affecting its location within the 
program or its parameter specifications. Use this command 
after setting an event point with the “EVENT: Specification” 
command. 

Syntax EV switch 

Terms switch = ON, OFF, or CLR 

Syntax Example EV CLR 

Notes ON enables the event trigger recognition feature, OFF dis- 
ables the event trigger recognition feature, and CLR clears the 
event setting. 

Spacing: A space is required between EV and switch. 

Example Command See Syntax Example above, and the ' 'EVENT: Specification” 

command. 
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EVENT; Specification 

Operation 

Sets the condition parameters for an event point trigger. 

Syntax 

EV [SJ=status][A=oddr][,D=data] 

Terms 

status = The type of cycle to trigger event on. This can be one 
of nine different names, including: 


M (memory access) 

P (port access) 

MR (memory read) 

MW (memory write) 

PR (port read) 

PW (port write) 

OF (operation code fetch) 
lA (interrupt acknowledge) 

ANY (don't care) 


addr = Specifies the address value to match for the event. 


data = Specifies the data value to match for the event. 

Syntax Example 

EV ST=MR,A=100,D = 55 

EV A=250 

Notes 

All parameters for this command are optional, and all 
parameters not defined remain unchanged. 


Both addr and data may be specified as "don't care” in 1-bit 
units (binary) or in 4-bit units (hex) by writing X at the required 
position. Also, any undefined parameter defaults as "don't 
care." 


When specifying a P, PR, or PW cycle for the event, and the 
port address is defined, the addresses should be defined as a 
16-bit address, with the upper 8 bits defined as "don't care." 
(Example; port address 34 = XX34.) 


ICD-278 for Z80 


ZAX Corporation 2-43 



MASTER COMMAND GUIDE 


Section 2 


EVENT 


Command Example 


Spacing: A space is required between EV and any of the para- 
meters. Spaces are not permitted between the parameters; 
commas are used to separate the parameters. 

Execute this sequence: 

> E V <- SHOWS EVENT STATUS 

Event is Clear <- shows absence of event points 

>EV ST=OF,A=7FF,D=4t sets an event point in the program 

>EV 

(ON) 

Status = OF 

Address = 07FF {0000_0'1 1 1 1 1 1 1) 

Data = 41 (0100_0001) 

>EV OFF •«- disables the event POINT SETTING 

>EV 

(OFF) <- shows event point setting is disabled 

Status = OF 

Address = 07FF (0000_01 1 1_1 1 1 1_1 1 1 1) 

Data = 41 (0100_0001) 

> 

In this example, the event point status is first checked, an 
event point is set in the program, and the status is checked 
again. The event point is then disabled temporarily, as a 
check of the status shows. 
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Command 

Operation 

Syntax 

Terms 


Notes 


EXAMINE 


EXAMINE Only or EXAMINE and Modify 

Examines one or more memory locations and optionally 
modifies them. The locations can be displayed and changed 
with either ASCII or hexadecimal values. 

E[AA/][/N] beg_addr[=mocl_clata] 

W = Use the word mode (the default is the byte mode). 

N = No-verify (the default is to read-verify after write). 

beg_addr = Starting address for display. 

mod_data = New data for this location. 

If mod_data is omitted, the command enters a repeat mode 
which allows several locations to be changed. When l\N option 
is selected, the word will be displayed or entered in LSB/MSB 
(Least Significant Bit/Most Significant Bit) order (bytes 
swapped). 

The repeat mode includes: 

return (cr) to display the next byte (word) of data, 
comma (,) to display the same byte (word) of data, 
caret ( -') to display previous byte (word) of data, 
slash (/) to exit the EXAMINE command. 

Spacing: A space is required before beg addr. No spaces 

are permitted between beg__addr and mocLdoto; the equal 
sign ( = ) acts as the separator. 
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Command Example >E 0 

0000 54 = 74, <- CHANGE VALUE TO 74H AND RE-EXAMINE 

0000 74 = <- LEAVE VALUE UNCHANGED, GO TO NEXT ADDRESS 

000 1 68 = <- LEAVE VALUE UNCHANGED, GO TO NEXT ADDRESS 

0002 69 = 'a ' change value and go to next address 

0003 73 = 74 " <- change value and go to previous address 

0002 61 = " <- LEAVE VALUE UNCHANGED, GO TO PREVIOUS ADDRESS 

000 1 68 = , •<- LEAVE VALUE UNCHANGED, RE-EXAMINE ADDRESS 

0001 68 = " •<- LEAVE VALUE UNCHANGED, GO TO PREVIOUS ADDRESS 

0000 74 = / «- LEAVE VALUE UNCHANGED, EXIT COMMAND 

>E/W 20 

0020 BFOA=4455, <- change word value, re-examine 

0020 4455= <- LEAVE VALUE, GO TO NEXT LOCATION 

0022 6DFF='Hr, •<- change value (ASCii), re-examine 
0022 4948 = •<- leave value, go to next location 

0024 FFFE= <- leave value, go to next location 
0026 EB29='' •<- leave value, go to previous location 

0024 FFFE = 0/ <- change value and exit command 

>E 20 

0020 55= «- examine ONLY 

0021 44 = 

0022 48 = 

0023 49= 

0024 00 = 

0025 00 = / 

> 
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Command 

Operation 

Syntax 

Terms 


Syntax Example 
Notes 

Command Example 


FILL 

FILL 

Fills a block of memory with either hexadecimal or ASCII 
codes. 

F[/W][/N] beg_addr,encS__acicir,data 

W = Fill memory contents of a word basis (the default is a byte 
basis). 

N = No-verify (the default is to read-verify after write). 

beg addr = The block beginning address to be filled. 

end^addr = The block ending address to be filled. 
data = Data that fills the block. 

F 'I00,3FF.55 

Spacing: A space is required before beg__addr. No spaces 
are permitted where the commas act as separators. 

See Syntax Example above. This example fills memory from 
address 100 to address 3FF with a data value of 55. 
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Command 

GO 

Operation 

Executes the user's program. 

Syntax 

G[b6g_addr][,end_addr][,end_acldr*2] 

Terms 

beg addr = The address to begin execution. 


end addr = The last address to execute. 


end addr#2 = Optional second ending address. 

Syntax Example 

G 

G 100 

G 0,800 

Notes 

All parameters for this command are optional. If beg_addr is 
omitted, the program continues from the current program 
counter. If encf_addr is omitted, the program continues until 
a breakpoint or a monitor break. When end_addr*2 is 
specified, the first location reached by execution {end_addr 
or end_addr*2) will cause a break. One hardware break- 
point each must be available to activate both the end__oddr or 
end_addr*2 parameters. 


Spacing: A space is required between G and any additional 
parameters. Spaces are not permitted where commas are 
used to separate the parameters. 

Example Command 

See Syntax Example above. The first example starts the pro- 
gram from the current program counter, the second example 
starts the program from address 100, and the third example 
starts the program from 0 and stops it at address 800. 
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Introduction 


Trace Width 
and Depth 


HISTORY 


HISTORY (Real-time Tracing) 

The real-time trace is one of the most powerful and useful 
features of your ICD. It allows you to record (hence the name 
"History” command) and then analyze a specific section of 
program execution, rather than sift through the entire program 
looking for a problem. Event points (which you set in the pro- 
gram) can trigger the real-time trace buffer to start or stop the 
data storage process when program execution begins, or con- 
tinues until a break occurs. 

By using the various storage modes, the real-time trace can 
effectively .capture any set of instructions within a program. 
The program execution can then be stopped, and the ad- 
dress, data, and control bus of the latest series of machine 
cycles can be displayed (in either machine cycle or disassem- 
bled format) on the console screen, or dumped to a printer 
(see the PRINT command). In this way, if a problem develops 
during the program execution, the real-time trace provides a 
record that can be reviewed to determine what the problem 
is. 


An emulator’s trace memory should be wide enough to ac- 
commodate the processor's address and data lines. With the 
ICD-278 for Z80, the trace memory is 32 bits wide (8 bits 
data/ 16 bits address/8 bits status). But when it comes to the 
trace memory’s depth, more is not always better. If too much 
depth is specified, it may be difficult to sift through all the data. 
However, if the trace memory depth is insufficient, the 
chances of recording the trace section where the problem 
exists are greatly diminished. Your ICD has a maximum trace 
memory depth of 2K (2047) machine cycles, but this may be 
reduced by specifying the "range" in the HISTORY command 
(except for the End Monitor and End Event modes). The ability 
to alter the size of the trace storage size permits very specific 
tracing. 
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HISTORY 

Real-ttme l^ace Buffer The data that is recorded from the program execution is 

stored in the real-time trace buffer. The real-time trace buffer 
can be thought of as a data storage facility that moves along 
parallel to the user program, storing the same data that is be- 
ing executed by the user program. The storage capacity of the 
real-time trace buffer is 2K machine cycles, and, in certain 
modes, when the buffer is full, it begins storing new data on a 
"First In/First Out” (FIFO) basis— writing over the oldest data 
it has stored. In this way, the buffer always displays the latest 
data it has stored. 
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HISTORY 

Triggers are the real workhorses of the real-time trace. They 
determine where (and when) the trace section is recorded 
within the user program. Your ICD features six different trig- 
ger modes, and specifications about each of the trigger modes 
are shown below. 

BEGIN MONITOR 

Specified by: H BM, trace range 

Activated by: GO command 

Terminated when: Buffer full 

FIFO when buffer full? No 

Range affects: Storage size 

End result in buffer: First 2K cycles executed 

END MONITOR 
Specified by: H EM 
Activated by: GO command 
Terminated when: Break in execution 
FIFO when buffer full? Yes 
Range affects: Nothing (ignored) 

End result in buffer: Last 2K cycles executed 

BEGIN EVENT 

Specified by: H BE, trace range 

Activated by: An event point 

Terminated when: Buffer full 

FIFO when buffer full? No 

Range affects: Storage size 

End result in buffer: 2K cycles following event 

CENTER EVENT 

Specified by: H CE, trace range 

Activated by: GO command 

Terminated when: An event point + range # of cycles 
FIFO when buffer full? Yes 
Range affects: Offset of event from center 
End result in buffer: 2K surrounding event 
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END EVENT 

Specified by: H EE 

Activated by: GO command 

Terminated when: An event point occurs 

FIFO when buffer full? Yes 

Range affects: Nothing (ignored) 

End result in buffer: Event point + previous 2K cycles 

MULTIPLE EVENT 

Specified by: H ME, trace range 

Activated by: An event point 
Terminated when: Buffer full 
FIFO when buffer full? No 

Range affects: Temporary storage termination until another 
event point 

End result in buffer; Several "snapshots" triggered by 
event points 
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Simplest case: An easy way to understand how the real-time trace works is 
Begin Monitor Mode to examine the Begin Monitor mode. With this mode, the GO 

command (which begins emulation) also triggers the start of 
real-time tracing, so that the data executed from the program 
memory area is simultaneously transferred to the real-time 
trace buffer. 

After the user program executes (and the buffer stores) the 
data equivalent of the range, the trace buffer fills to that point 
and then stops. The data that is now stored in the buffer is the 
“captured” trace section (the section that the ICD displays). 
The real-time trace then enters a non-trace mode and stops 
when a MONITOR break (accomplished by pressing the 
MONITOR switch) or breakpoint is encountered. 



not tracing tracing memory "captured" trace 
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Begin Event Mode The Begin Event mode works in the same way as the Begin 
Monitor mode except that an event point triggers the real-time 
trace instead of the GO command. The buffer stores the 
amount specified by the range (up to 2K) and then stops. 

NOTE: The event itself is not stored in the buffer, but triggers 
the buffer to begin storing. 


event point 



not tracing tracking memory "captured" trace 
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End Monitor Mode The End Monitor mode begins storing all data, and then ter- 
minates the storage process when a breakpoint is encounter- 
ed or when the MONITOR switch is pressed, The captured 
trace section is the last 2K before the breakpoint or MONITOR 
break. 

The ICD accomplishes this type of tracing by recording and 
storing data on a First-In/First-Out (FIFO) basis after the buffer 
is filled. By using this technique, the ICD always displays the 
latest data in the trace buffer. 

The End and Center Event modes use this same FIFO record- 
ing technique in their operation. 



"captured" data 
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End Event Mode The End Event mode works in the same way as the End Mon- 
itor mode except that an event point (instead of a breakpoint) 
triggers the buffer to stop storing data. The captured trace 
section is the last 2K before and including the event point, 
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Center Event Mode The Center Event mode is used when you desire the trace to 

surround a single event point in the program. The Center 
Event mode takes the range specification and records that 
number of cycles after the event point occurs. The remainder 
of the 2K buffer contains cycles just prior to and including the 
event point. For example, if IK is specified as the range, IK of 
data is captured before the event point, and IK is captured 
after the event point. If the specified range is 2000, 45 cycles 
would be captured before the event, and 2000 after. 

Just like the End Monitor and End Event mode, the Center 
Event mode causes the real-time trace to start recording data 
immediately after the GO command. 
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Multiple Event Mode The Multiple Event mode is identical to the Begin Event mode, 

with the exception that when the trace range is filled, the trac- 
ing is only temporarily stopped until another event point 
occurs. Then the buffer is re-opened to continue storing an- 
other trace range number of cycles. When the 2K buffer is 
filled, the event points are then ignored, and the buffer re- 
mains in a non-storage mode. This allows several occurrences 
of the event to trigger the History buffer, giving several “snap- 
shots" of a particular routine. 

NOTE: The smaller the trace range, the more times the event 
can retrigger the buffer before it fills and begins to ignore 
event points. 
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Command HISTORY: Real-time Trace Status 

Operation Displays the current status of the real-time trace buffer. 

Applications Note: Use the real-time trace status to analyze the 
condition of the real-time trace buffer, i.e., storage mode 
name, size of the trace range, the number of cycles executed, 
and the number of cycles stored in the History buffer. 

When the real-time trace specifications are changed, the 
“HISTORY: Status" command will display their latest settings. 

Syntax H 

Command Example >H 

Clock Counts = 00000000/0 <- number of clock cycles 

Storage Mode = BE 2045 •<- mode and trace range 

Storage Size = 0/0 <- number of cycles passed 

In this example, "Clock Counts" shows the number of clock 
cycles (T-states) since the real-time trace was cleared. The 
number to the left of the slash (/) is the hexadecimal number of 
clock cycles, and the number to the right is its decimal equiv- 
alent. “Storage Mode” shows that the "Begin event” mode has 
been specified and that the trace range is 2045. "Storage 
Size” shows the number of cycles since the program was start- 
ed (to the right of the slash) or since the program was resumed 
(to the left of the slash). "Full” indicates a full buffer, or 2045 
cycles. 
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Command 

Operation 

Syntax 

Notes 

Command Example 


HISTORY: Real-time Trace Counter Reset 
Clears (resets) the clock counter. 

H CLR 

Spacing: A space is required between H and CLR. 
See the examples that begin on page 2-63. 
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HISTORY 

HISTORY: Real-time Trace Format Display 

Operation 

Allows the contents of the real-time trace buffer to be dis- 
played in either machine cycle format or disassembled 
format. 

Syntax 

H moclelint_point][,term_poinf\ 

Terms 

mode = M or D 


inf point = Initial point of display, from I to 2047. 


term point = Point at which display terminates, from 1 to 

2047. 

Syntax Example 

H M,200,100 

H D 

Notes 

M specifies to display the program execution in machine cycle 
format. D displays the program execution in disassembled 
format. With this command, /n/_po/nf must be greater than or 
equal to term_point. The storage pointer is numbered by bus 
cycles— displayed from high to low— where "1” is the most 
recent bus cycle. 


This command displays items on a line-for-line basis. To con- 
trol the scrolling of the display, alternately press the space 
bar. To exit the display, press the Escape (Esc) key. 


Spacing: A space is required between H and mode. No 
spaces are permitted where commas are used as separators. 

Command Example 

See the examples that begin on page 2-63. 
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Command 

HISTORY: Real-time Trace Storage Mode 

Operation 

Specifies the trace mode for the real-time trace buffer. This is 
the command that specifies what activates the real-time trace 
feature. 

Syntax 

H moafe[, range] 

Terms 

mode = Trace mode. This can be one of six different modes, 
including: 


BM (begin monitor mode) 

EM (end monitor mode) 

BE (begin event mode) 

CE (center event mode) 

EE (end event mode) 

ME (multiple event mode) 


range = The trace range, from 1 to 2045. 

Syntax Example 

H ME, 800 

Notes 

The range specified for the EM and EE modes will be ignored; 
it defaults to the maximum 2K size. 


Spacing: A space is required between H and mode. No 
spaces are permitted where the commas are used as separa- 
tors. 

Command Example 

See the examples that begin on page 2-63. 


2-62 ZAX Corporation 


ICD-278 for Z80 


Section 2 


MASTER COMMAND GUIDE 


HISTORY 

HISTORY: Real-time NOTE: To illustrate the following examples, memory locations 

Trace Command from 0 to 1 FFF are first filled with NOP instructions. NOPs will 

Examples he displayed for all the examples. 

Example trace mode: End Monitor 
Command format: H EM 
Trace range; 2K 

The ICD defaults to the End Monitor mode when it boots up. 
Execute the following; 


>10 ■<- SPECIFY IN-CIRCUIT MODE 0 

> F 0,1 FFF,0 <- FILLS 0 TO 1FFF WITH NOPs (IT TAKES A FEW SECONDS 

FOR THE ICD TO DO THIS) 

> B/ A OF, 1 7 70 <- SETS A hardware breakpoint to terminate 

EMULATION 

>G 0 <- STARTS EMULATION and INITIATES REAL-TIME trace STORAGE. 

ICD RUNS PROGRAM, STOPS AT BREAKPOINT A, AND DISPLAYS: 

1770 00 NOP 0000 0000 0000 0000 0000 0000 0000 00 0 0000 

< Break Hardware A > 

> 

Now enter; 


> H D <- DISPLAYS REAL-TIME TRACE CONTENTS IN DISASSEMBLED FORMAT 
(USE THE SPACE BAR TO CONTROL SCROaiNG; PRESS THE ESC KEY 
TO EXIT) 


POINT T 

ADDR 

DT 

ST 

OP 

t2047 

0F73 

00 


NOP 

2046 

OF74 

00 


NOP 

i 

1 

i 



0003 

176F 

00 


NOP 

0002 

0001 

1770 

PAUSE 

00 


NOP 


NOTE: POINT = Address in HISTORY Buffer, T = Event point 
indicator, ADDR = Cycle address, DT = Cycle data, OP = Op 
code. 


1[NOTE: Displays memory contents from beginning of storage 
pointer. 
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PC MC OP 
< Break Hardware A > 
> 


Example trace mode: Begin Monitor 
Command format: H BM 
Trace range: 2K 

This example continues from the Event Monitor example and 
uses the same program. 

Execute the following: 

>H CLR RESETS THE CLOCK COUNTER 

> H BM SETS THE REAL-TIME TRACE TO THE BEGIN MONITOR MODE 

>B/A OF,OFAO «- SETS A HARDWARE BREAKPOINT TO TERMINATE 

EMULATION 

> G 0 <- STARTS EMULATION AND INITIATES THE REAL-TIME TRACE STORAGE. 

ICD RUNS PROGRAM. STOPS AT BREAKPOINT A, AND DISPLAYS: 


SP AP .BC. DE HL IX lY 


IF 


fSPl 



Now enter: 

>H D <- DISPLAYS REAL-TIME TRACE CONTENTS IN DISASSEMBLED FORMAT 
(USE THE SPACE BAR TO CONTROL SCROLLING; PRESS THE ESC KEY 
TO EXIT) 


POINT 

T ADDR 

DT 

ST OP 

2047 

• 0000 

00 

NOP 

2046 

0001 

00 

NOP 

; 


1 

i 

0002 

07FD 

00 

NOP 

0001 

PAUSE 




*NOTE: Indicates trigger point. 
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Example trace mode: Begin Event 
Command format: H BE 
Trace range: 2K 

This example continues from the Begin Monitor example. 

>H CLR <- RESETS THE CLOCK COUNTER 

>H BE "-SETS THE REAL-TIME TRACE TO THE BEGIN EVENT MODE 

> E V ST = OF, A = 1 7 7 0 <- sets an event point 

> B/A OF, 1 F40 <- sets a hardware breakpoint to terminate 

EMULATION 

>G 0 •<- STARTS EMULATION. ICD RUNS PROGRAM, stops AT 

BREAKPOINT A AND DISPLAYS: 

PC MC OP SP AF BC DE HL IX lY 1 IF (SP) 

IF40 00 NOP 0000 0000 0000 0000 0000 0000 0000 00 0 0000 

< Break Hardware A > 

> 


Now enter: 

> H D <- DISPLAYS REAL-TIME TRACE CONTENTS IN DISASSEMBLED FORMAT 
(USE THE SPACE BAR TO CONTROL SCROLLING; PRESS THE ESC KEY 
TO EXIT) 


POINT T 

ADDR 

DT 

ST 

OP 

2002 • 

1770 

00 


NOP 

2001 

1771 

00 


NOP 

i 

i 

1 



0002 

1F40 

00 


NOP 

0001 

PAUSE 





*NOTE: Indicates event point. 
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Example trace mode: Center Event 
Command format: H CE 
Trace range: 2K 

This example continues from the Begin Event example. 

>H CLR <- RESETS THE CLOCK COUNTER 

> H CE •<- SETS THE RE/y.-TIME TRACE TO THE CENTER EVENT MODE 

>EV ST=OF,A=1770 <- sets an event point 

> B/A OF, 1 F40 sets a hardware breakpoint to terminate 

EMULATION 

>G 0 ■<- STARTS EMULATION AND INITIATES THE real-time TRACE STORAGE. 

ICD RUNS PROGRAM, STOPS AT BREAKPOINT A, AND DISPLAYS: 

PC ME OP SP AF BC DE HL IX lY I IF (SP) 

IF40 00 NOP 0000 0000 0000 0000 0000 0000 0000 00 0 0000 

< Break Flardware A> 


Now enter: 

> FI D DISPLAYS REAL-TIME TRACE CONTENTS IN DISASSEMBLED FORMAT 

(USE THE SPACE BAR TO CONTROL SCROLLING; PRESS THE ESC KEY 
TO EXIT) 


POINT 

T ADDR DT 

ST 

OP 

2047 

1371 0 


NOP 

2046 

1372 00 


NOP 

1 

i 1 



1025 

176F 00 


NOP 

1024 

* 1770 00 


NOP 


i 1 


1 

0002 

1B6E 00 


NOP 

0001 

PAUSE 




*NOTE: Indicates event point. 
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Example trace mode; End Event 
Command format: H EE 
Trace range: 2K 

This example continues from the Center Event example. 
Execute the following: 

>H CLR •«- RESETS THE CLOCK COUNTER 

> H EE ■<- SETS THE REAL-TIME TRACE TO THE END EVENT MODE 

>EV ST=OF,A=1770 <- sets an event point 

>B/E ON ■*- enables AN EVENT POINT BREAK 

> G 0 <- STARTS EMULATION AND INITIATES THE REAL-TIME TRACE STORAGE. 

ICD RUNS PROGRAM, STOPS AT EVENT POINT, AND DISPLAYS; 

PC ME OP SP AF BC DE HL IX lY I IF (SP) 

1770 00 NOP 0000 0000 0000 0000 0000 0000 0000 00 0 0000 

< Break Event > 

> 


Now enter: 

> H D •<- DISPLAYS REAL-TIME TRACE CONTENTS IN DISASSEMBLED FORMAT 
(USE THE SPACE BAR TO CONTROL SCROLLING; PRESS THE ESC KEY 

TOExrn 


POINT 

T ADDR 

DT 

ST OP 

2047 

0F73 

00 

NOP 

2046 

0F74 

00 

NOP 

1 

i 

i 

i 

0005 

176D 

00 

NOP 

0004 

176E 

00 

NOP 

0003 

176F 

00 

NOP 

0002 

• 1770 

00 

NOP 

0001 

PAUSE 




*NOTE: Indicates event point. 
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Example trace mode: Multiple Event 
Command format: H ME 
Trace range: 100 

This example continues from the End Event example. For this 
example, a Jump (JP) instruction is added at location FFE so that 
the ICD will loop during execution. (Loop passing counts are 
added to the breakpoint.) 

Execute the following: 

>A FFE 

ICD Displays: Your Response: 

OFFE JP OH <cr> 

1001 <cr> 

>H CLR <- RESETS THE CLOCK COUNTER 

> H ME, 1 00 <- SETS THE REAL-TIME TRACE TO THE MULTIPLE EVENT MODE 

AND THE STORAGE SIZE AS 100 INSTRUCPONS PER LOOP 

>B/A OF,F00,50 ♦- sets a hardware breakpoint to terminate 

EMULATION 

> EV ST= OF, A =0700 <- sets an event point 

> B/E OFF <- disables program break by an event point 

>G 0 «- STARTS EMULATION 

ICD runs program, stops at hardware breakpoint, and 
displays: 

PC MC OP SP AF BC DE HL IX lY I IF (SP) 

OFOO 00 NOP 0000 0000 0000 0000 0000 0000 0000 00 0 0000 

< Break Hardware A > 
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Now enter: 

> H D «- DISPLAYS REAL-TIME TRACE CONTENTS IN DISASSEMBLED FORMAT 
CUSE THE SPACE BAR TO CONTROL SCROLLING; PRESS THE ESC KEY 
TO EXITI 


POINT 

T ADDR 

DT 

ST 

OP 

2047 

075F 

00 


NOP 

2046 

0760 

00 


NOP 

1 

i 

1 


1 

1922 

* 0700 

00 


NOP 

i 

1 

i 


1 

CM 

O O 
O O 

o o 

0764 

PAUSE 

00 


NOP 


*NOTE: Indicates event point. 
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Command 

HISTORY : Real-time Trace Search 

Operation 

Allows you to search through the History trace buffer for cer- 
tain specified operations. For example, "find all of the times a 
memory write operation to memory location 1234H occurred." 

Syntax 

H SJ[data]l[cycle][,int_polnt][,term_poinf\ 

Terms 

Qddr = Value to search for. 


data = Data to search for. 


cycle = Type of machine cycle, and includes one of the fol- 
lowing: 


MR (memory read) 

MW (memory write) 

PR (port read) 

PW (port write) 

Ml (opcode fetch) 
lA (interrupt acknowledge) 

HA (halt acknowledge) 


int_polnt = Initial point of display, from 1 to 2047. 


term point = Point at which display terminates, from 1 to 

2047. 

Syntax Example 

H S,/100/55/MR,200,100 
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Notes If data is specified, addr specification is also required. The 

int_point defaults to 2047, and term point defaults to I , 

otherwise int_point must be specified as greater than or 
equal to term point. 

The storage pointer is numbered by bus cycles, displayed 
from high to low, where ‘ ' 1' ’ is the most recent bus cycle. 

This command displays items on a line-for-line basis. To con- 
trol the scrolling of the display, alternately press the space 
bar. To exit the display, press the Escape (Esc) key. 

Spacing: A space is required between H and S, and thereafter 
no spaces are permitted; slashes (/) and commas (,) are used 
to separate information. If addr, data, or cycle is excluded, 
slashes must still be present (eg., H S,///MR). 

Command Example See Syntax Example. 
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Command IDENTIFICATION 

Operation Displays the current ICD device name and the firmware 
version. 

Syntax ID 

Notes This display is also shown when the RESET switch is pressed 
on the ICD. 

Command Example >ID 

ICD-278 for Z80 V2.0 

This example shows that the ICD emulates the Z80 processor 
and that the firmware version within the ICD is 2.0. Your firm- 
ware version may be different, depending on your purchase 
date. 
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Command IN-CIRCUIT: Status 

Operation Displays the current in-circuit status, either 0, 1, or 2. The 
in-circuit status is also displayed when the "MAP: Status" 
command is used. 

Syntax I 

Command Example See the MAP command. 
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Command 

IN-CIRCUIT: Specification 

Operation 

Sets the ICD mapping mode. See Notes (below) and the MAP 
command for an explanation and example of the different 
mapping modes, 

Syntax 

1 [mode] 

Terms 

mode = 0, 1 , or 2 

Syntax Example 

1 0 

Notes 

0 = System mode. Debugging is performed using the ICD 
program memory only. The area specified as US (user mem- 
ory) by the MAP command acts as RW (read/write memory) 
in the ICD. Target system I/O and interrupt signals are ig- 
nored. 


1 = Partial mode. Debugging is performed using the ICD pro- 
gram memory and user (target system) memory, as defined 
by the MAP command. Interrupts can be disqualified by using 
the PIN command. 


2 = All mode. Debugging is performed using only the target 
system memory. Memory now mapped as read/write and 
read-only act as user (target system) memory. I/O and inter- 
rupts are enabled. Any area mapped as NO (non-memory) 
will act as NO memory regardless of the in-circuit mode. 
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IN-CIRCUIT 

In-circuit mode settings and memory specifications are shown 
below, 


In-circuit 

Memory Type 

PIN Functions 

Mode/Description 

RO 

RW 

US 

NO 

EN 

Dl 

10/System Mode 

RO 

RW 

(RW) 

NO 

(Dl) 

Dl 

It /Partial Mode 

RO 

RW 

US 

NO 

EN 

Dl 

12/All Mode 

[US) 

(US) 

US 

NO 

EN 

(EN) 


( ). Items in parentheses show the revised memory or PIN 
specification for that particular in-circuit mode. 

Spacing: A space is required between I and mode. 

See the MAP command. 
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Command MAP: Status 

Operation Displays the current memory assignments and address para- 
meters as defined by the "MAP: Specification’’ command. 

Syntax MA 

Command Example Execute this sequence: 

>10 <- USES ICD'S MEMORY RESOURCES 

> MA <- SHOWS HOW MEMORY IS CATEGORIZED 

In-Circuit Mode 0 (US= >RW) 

0000-FFFF = RW 

In this example (default condition), the in-circuit mode is first 
set to 0 (debugging using ICD memory only), and then the 
MAP status command is entered. The display shows that in- 
circuit mode is indeed 0, that user (target system) memory 
now acts as read/write memory (US= >RW), and that the 
entire memory area is categorized as read/ write. A second 
example is shown below: 

>12 •<- USES TARGET SYSTEM'S MEMORY RESOURCES 

> M A •«- SHOWS HOW THE MEMORY IS CATEGORIZED 

In-Circuit Mode 2 (RW,RO = > US) 

0000-FFFF = RW 

In this example, the I 2 mode (debugging using target system 
memory only) is selected, and then the MAP status is request- 
ed. The display shows that the in-circuit mode has changed to 
2, and that all memory categorized as read/write or read-only 
(from 0000 to FFFF) now functions as user (target system) 
memory. 
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Command 

MAP 

MAP: Specification 

Operation 

Categorizes your target system’s memory functions as either 
read-only, read/write, user (target system), or non-memory 
area. 


Applications Note: This command can be used to develop 
your target system’s firmware (ROM) by allowing code in a 
mainframe system to be downloaded to the ICD, mapped as 

RO, and tested before being "burned” into the target’s ROM. 

Syntax 

MA beg^addr[,end_xiddr]=area 

Terms 

beg addr = The beginning address of mapping. 


end addr = The ending address of mapping. 


area = RO, RW. US, or NO 

Syntax Example 

MA 'I000,1FFF=RW 

MA 150 = RO 

Notes 

The target system or ICD memory is used in IK-byte blocks. 

The parameters are only valid when the in-circuit mode is 1 1 . 

(See IN-CIRCUIT command.) 


If the beg addr or end addr does not coincide with the 

beginning or ending of a IK block location, the beginning or 

ending area is assigned a location that includes beg addr or 

end_addr. 


IK block areas are predefined as addresses X000-X3FF, 
X400-X7FF, X800-XBFF, XOOO-XFFF. 
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Command Example 


Two of the areas, RO and RW, refer to ICD user memory, and 
RW gives the user program free access to this memory. RO 
enables the user program to read this memory, but any at- 
tempt to write to this area will be blocked, and (unless the 
B/W breakpoint is disabled) will also cause a break. 

US acts as target system memory area (US being RAM, ROM, 
I/O, etc.— whatever resides at those locations in the target). 
NO memory assignment causes a break in the program if an 
attempt is made to access this non-existent memory area. A 
NO memory area is recognized as such, regardless of the 
in-circuit mode. 

Spacing: A space is required between MA and beg addr. 

No spaces are permitted after beg addr, the comma (,) and 

equal sign ( = ) act as the separators. 

Execute this sequence; 

>11 USES BOTH ICD'S AND TARGET SYSTEM'S MEMORY RESOURCES 

>MA 0000,0FFF = RO 

>MA lOOO.IFFF = US <- categorizes memory blocks 
>MA 2000,FFFF = RW 
> 

> MA ■<- SHOWS HOW THE MEMORY IS CATEGORIZED 

In-Circuit Mode 1 
OOOO-OFFF = RO 
1000-1FFF = US 
2000-FFFF = RW 
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In this example, the 1 1 (debugging using both ICD memory 
and target system memory) is selected, and then the memory 
blocks are categorized as read-only (0 to FFF), user (1000 to 
1FFF), and read/write (2000 to FFFF). The MAP status com- 
mand is then entered, showing how the memory was just 
specified. A second example is shown below: 

>12 <- USES TARGET SYSTEM'S MEMORY RESOURCES 

> MA <- SHOWS HOW THE MEMORY IS CATEGORIZED 

In-Circuit Mode 2 (RW,RO= >US) 

OOOO-OFFF = RO 
1000-1 FFF = US 
2000-FFFF = RW 

In this example, the I 2 (debugging using target system mem- 
ory only) is selected, which therefore categorizes read/write 
and read-only memory areas (from 0 to FFFF) as user (target) 
memory (RW,RO= >US). A third example follows: 

> i 0 USES ICD'S MEMORY RESOURCES 

> MA SHOWS HOW THE MEMORY IS CATEGORIZED 

In-Circuit Mode 0 (US= >RW) 

0000-FFFF = RW 

In this example, the I 0 (debugging using ICD memory only) 
is selected, which is the default condition for the ICD. When 
the status of the MAP command is examined, it shows that user 
(target system) memory acts as read/write memory. Read- 
only memory can still be specified in this mode. 
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Command MOVE 

Operation Moves the memory contents between different locations 
within the ICD, or between the ICD and the target system. 

Syntax M b6g_adclr,encl^aclclr,mov__adclr[, direction] 

Terms beg addr = Beginning address of data source. 

end addr = Ending address of data source. 

mov addr = Beginning address for destination. 

direction = UP or PU 

Syntax Example M 1 00,200, lOO.UP 

Notes UP means that the source is user (target system) memory and 
the destination is ICD program memory. PU means that the 
source is ICD program memory and the destination is user 
(target system) memory. If direction is omitted, data is relo- 
cated within the memory areas as specified by the MAP com- 
mand. 

Spacing: A space is required between M and beg_oddr. No 
spaces are permitted where commas are used as separators. 

Command Example See Syntax Example above. In this example, a block of mem- 
ory in the target system, beginning at address 100 and ending 
at address 200, is moved to the ICD beginning at address 100. 
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Command NEXT 

Operation This command is a subcommand of the TRACE command. It 
allows the next 1 to 65,535 instructions to be executed and trac- 
ed in non-real time from the current program counter. 

Syntax N [steps] 

Terms steps = 1 to 65,535 

Syntax Example N 5 

Notes The steps means the number of instructions to execute from 
the current program counter, and may be any integer from 1 
to 65,535. If steps is omitted, only a single instruction line is dis- 
played. 

When the registers’ contents are displayed as a series of 
periods (....), it indicates that the contents of the registers 
are unchanged. The registers’ contents are displayed fully, 
however, at least once every 22 lines. 

Spacing: A space is required between N and steps. 
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Command Example Press the RESET switch on the ICD, then execute this 

sequence: 

>F 0,FFF,0 •<- FILLS MEMORY WITH NOPS 

> G 0,2FF ■<- STARTS THE PROGRAM RUNNING FROM ADDRESS 0 

AND STOPS AT ADDRESS 2FF, THEN DISPLAYS; 

PC MC OP SP AF BC DE HL IX lY I IF (SP) 

02FF 00 NOP 0000 0000 0000 0000 0000 0000 0000 00 0 0000 

< Break Flardware A > <- program breaks at addr 2 ff 

> N 3 <- shows the next three instruction lines 


PC 

MC 

OP 

SP AF BC DE HL IX lY 

1 

IF 

(SP) 

0300 

00 

NOP 

0000 0000 0000 0000 0000 0000 0000 

00 

0 

0000 

0301 

00 

NOP 

0000 0000 0000 0000 0000 0000 0000 

00 

0 

0000 

0302 

> 

00 

NOP 

0000 0000 0000 0000 0000 0000 0000 

00 

0 

0000 


This example illustrates how the NEXT command is used with 
the program execution. When the program stops at address 
2FF, entering N 3 causes the next three instruction lines to be 
displayed. 
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Command 
Operation 
Syntax 
Command Example 


OFFSET: Status 

Displays the status of the "OFFSET: Specification" command. 
O 

> O SHOWS THE STATUS OF THE OFFSETS 

&0 = 0000 <- SHOWS THE DEFAULT CONDITIONS (ALL OFFSET REGISTERS = 0) 

= 0000 
&2 = 0000 
&3 = 0000 


This example shows the default conditions of the OFFSET 
command. Changing the address of any one of the four offset 
values (0-3) causes a change in the 0000 display. 
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Commqnd OFFSET: Specification 

Operation Sets an offset in the ICD for relative program addressing. 

Applications Note: This command is useful when debugging a 
program that consists of a number of different modules. The 
procedure would be to assign the physical base address for 
each module to one of the offset registers. Any location in a 
module may be addressed by specifying its relative address 
to that module's base address, plus an offset register. The ad- 
dress parameter of any command will then be interpreted as 
the sum of the relative address and the offset register (physical 
base address). 

Syntax O 8mumber[=addr] 

Terms number = 0, 1 , 2, or 3 

addr = Offset to place in the register. 

Syntax Example O &2=FFF 

Notes Any of the four offset registers can be used with any of the ICD 

command memory addressing parameters. 

When addr is omitted, the offset register is cleared to zero. 

Spacing: A space is required between O and &. No spaces are 
permitted between &number=addr, the equal sign (=) acts as 
the separator. 
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Command Example Execute this sequence: 

> O & 1 = 2240 *- SETS *‘\ VALUE TO OFFSET OF 2240 

> O SHOWS CURRENT OFFSET VALUES 


&0 = 0000 
SlI = 2240 
&2 = 0000 
&3 = 0000 

> Dl 2 1 2& 1 «- DISASSEMBLES FROM ADDRESS 212 + THE OFFSET VAUJE 

2452 • ■ ■ • ■ ■ • ■ P,OF92FH <- display begins 

2455 .... .... AT2240 + 212 = 2452 

2456 A,B 

2457 

etc. ■ • • • ■ ■ ■ • 

NOTE: . ... = Example display. 
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Command PIN: Status 

Operation Displays the current status of the “PIN: Specification" com- 
mand. 


Syntax PI 


Command Example 


> PI <- SHOWS STATUS OF INTERRUPT SIGNALS 

In-Circuit Mode 1 
NMI/ (EN) = H 
INT/ (EN] = H 

BUSRQ/ (EN) 


This example shows that the in-circuit mode is 1 , which allows 
the interrupt signals to be individually enabled and disabled. 
With this example, all interrupt signals are enabled (EN). If the 
be-enableai lildats-vm'S'kr.'amhterruiji sigf'raiss'WcnJi’a 

automatically be disabled. H shows that the current logic levels 
of the signal are high. The slash (/) after the signal name 
signifies an "active-low” signal. 
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PIN 

Command PIN: Specification 

Operation Masks or unmasks selected input signals when the in-circuit 
mode is ^ . 

Syntax PI signal=switch 

Terms signal = NMI (Non-Maskable Interrupt) 

INT (Maskable Interrupt Request) 

BUSRQ (Bus Request) 

switch = EN or Dl 

Syntax Example PI BUSRQ =DI 

Notes The parameters for this command are only valid when the 
in-circuit mode is 1 . When the in-circuit mode is 2, all signals 
are valid. When the in-circuit mode is 0, all target system 
signals are ignored. 

EN is used to enable the signal and Dl is used to disable the 
signal. 

Spacing; A space is required between PI and signal. No 
spaces are permitted after signal. 
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PIN 

Command Example Execute this sequence; 

>11 <- SETS MODE TO PERMIT INTERRUPT FEATURE 

>PI <- SHOWS STATUS OF INTERRUPTS 

In-Circuit Mode 1 
NMI/ (EN) = H 
INT/ (EN] = H 
BUSRQ/ (EN) 

>P| |NT=DI DISABLES THE INT SIGNAL 

> PI •<- SHOWS THE STATUS OF INTERRUPTS AGAIN 

In-Circuit Mode 1 
NMI/ (EN) = H 

INT/ (Dl) = H •(-VERIFIES THE CHANGE 

BUSRQ/ (EN) 


In this example, the in-circuit mode 1 is selected (ICD and 
target system memory resources) to manipulate the various 
interrupt signals. The PIN status then shows that all the inter- 
rupts are active (E/Vabled). Next, the Interrupt Request (INT) 
signal is disabled, and the PIN status used again to verify the 
change. 
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PORT 

PORT 

Operation 

Examines one or more I/O port locations and optionally mod- 
ifies them. The locations can be displayed and replaced with 
either hexadecimal or ASCII values. 


This command works on the same principle as the EXAMINE 
command, except that the port address accesses the I/O port 
space. 


P port_addr[=mod_data] 

Terms 

port addr = Starting address for display. 


mod_data = New data for this location. 

Syntax Example 

P FF = 23 

P 55 

Notes 

If mocL-dOffo is omitted, the command enters a repeat mode, 
which allows several locations to be changed. 


The repeat mode includes: 


return (cr) to display the next byte (word) of data, 
comma (, ) to display the same byte (word) of data, 
caret (~) to display previous byte (word) of data, 
slash (/) to exit the PORT command. 


Spacing: A space is required between P and port addr. No 

spaces are permitted between port_addr and mod_data\ 
the equal sign ( = ) acts as the separator. 

Command Example 

See Syntax Example. The first example illustrates how the port 
located at address FF is changed to a data value of 23. The 
second example allows the ports to be modified, beginning at 
address 55. See EXAMINE command examples for additional 
information. 
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Command 

Operation 

Syntax 
Terms 
Syntax Example 
Notes 


Command Example 


PRINT 

Controls logging of ICD commands by sending the terminal 
display to an external serial printer. 

PR switch 

switch = ON or OFF 
PR ON 

ON enables the printing feature and OFF disables the printing 
feature. 

The printing is routed to the HOST/AUX port when the ICD is 
in LOCAL mode, and to the host printer when the ICD is in 
REMOTE mode (using ZICE, or the LOCAL "HOST ON” mode 
using ZICE). 

Spacing; A space is required between PR and switch. 

See Syntax Example above. 
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REGISTER 


Command REGISTER; Status 

Operation Displays the current status of the registers and any changes 
made after using the "REGISTER; Examine and Change" 
command. 

Syntax R 


>R 


/ 


a> 












0< ,<? .(f* ,& 








4> 


, 0 ' 


<F <i? T d 


/ / i . 

/ / / / / 

/ / / / ^ 

/ ^ ^ ^ ^ 


/ 


Sr 




<y 

<r 




aT^* 




# 


/ 


I i <1 / / z 

PC SP SZHPNC A BC DE HL IX lY A'F' B'C' D'E' HI' I IF (SP) (HL) 
0303 0000 000000 00 0000 0000 0000 0000 0000 0000 0000 0000 0000 00 0 0000 00 


/ 

/// 
^ o 
/ 


This example shows the status of the registers (currently all 0). 
Changing any of the registers with the "REGISTER: Examine 
and Change” command affects this display. 
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REGISTER 

Command REGISTER: Reset 
Operation Sets all the registers to zero. 

Syntax R RESET 

Notes Spacing: A space is required between R and RESET. 
Command Example Execute this sequence: 

> R SHOWS THE STATUS OF THE REGISTERS 

>R A = AF <- SETS REGISTER A TO A VALUE OF AF 

> R <- SHOWS THE STATUS OF THE REGISTERS AGAIN 
>R RESET <- RESETS ALL REGISTER VALUES TOO 

> R <- VERIFIES THE CHANGE TO 0 

This example shows how register A is changed from 00 to AF, 
and then set back to 00 using the "REGISTER: Reset" com- 
mand. 
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REGISTER 

Command REGISTER: Examine and Change 

Operation Examines and changes the contents of the Z80 internal regis- 
ters. 

Syntax R reg^ame[=clata] 

Terms reg name = Any one of the following registers: 


A 

A' 

PC 

SP 

IX 

lY 

B 

C 

BC 

B' 

C' 

BC' 

D 

E 

DE 

D' 

E' 

DE' 

H 

L 

HL 

H' 

L' 

HL' 

1 

IF 

F 

F' 

S Z 

P N CY 


data = New value for register contents. 

Syntax Example R HL=A000 
R DE 

Notes If R reg^name is entered, this command displays the current 
contents of the specified register. If data is used, this com- 
mand changes the contents of the specified register to the new 
value. 

For reg name(s) IF,S,Z,P,N, and CY, only 0 and 1 are valid 

data entries. 

Spacing: A space is required between R and reg_types. No 

spaces are permitted after reg types] the equal sign ( = ) acts 

as the separator. 
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REGISTER 

Command Example Execute this sequence: 

>R DE = 2FFF <- sets the deregister to 2 fff 

>R DE <- SHOWS THE VAIJUE OF THE DEREGISTER 
2FFF <- VALUE OF DE REGISTER 
> R ■<- SHOWS THE VALUES OF AU THE REGISTERS 

>R 

PC SP SZHPNC A BC DE HL IX lY A'F' B'C' D'E' HI' I IF (SP) (HL) 
0000 0000 000000 00 0000 2FFF 0000 0000 0000 0000 0000 0000 0000 00 0 0000 00 

This example illustrates how a register is changed to a new 
value, and the two ways that it can be checked. 
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SEARCH 

Command 

SEARCH 

Operation 

Searches the memory contents and displays the matching or 
unmatching data, if any. 

Syntax 

S[AA/][/D] beg_acldr,end_acldr,search_data 

Terms 

W = Word search (if omitted, byte search is made). 


D = Search for unmatching data (if omitted, search is made for 
matching data). 


beg addr = Address to begin search. 


end_addr = Address to end search. 


search_data = Data to search for. 

Syntax Example 

S/D 100,7FB55 

Notes 

This command displays items on a line-for-line basis. To control 
the scrolling of the display, alternately press the space bar. To 
exit the display, press the Escape (Esc) key. 


Spacing: A space is required before beg addr. No spaces 

are permitted where the commas act as separators. 

Command Example 

See Syntax Example above. This example illustrates that a 
search of the memory contents is made from address 100 to 
address 7FF. The display will show all locations that contain 
data other than 55H. 
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Command SUPERVISOR 


Operation Provides a way to access the ICD's serial ports (TERMINAL or 

HOST/AUX) from the user program by using specified break- 
points as supervisor calls to the ICD system program. 

The breakpoints, specified by the BREAK command, do not 
stop the program being emulated, but perform input/output to 
the ICD serial interface only 


Syntax 

Terms 

Syntax Example 


S\J[lbreak switch] 

break = C, 7, or U 

switch = ON or OFF 

SU/7 ON 
SU 


Notes C specifies to use hardware breakpoint C as a supervisor call, 

7 specifies to use software breakpoint 7 as a supervisor call, 
and U specifies to use a user software breakpoint as a super- 
visor call. ON enables the specified breakpoint (C, 7, or U), 
and OFF disables it. 

If a user software breakpoint is specified, the supervisor call 
will occur at each user software breakpoint. In this way, mul- 
tiple calls can be used throughout a program. 

The function code of the supervisor call is specified in the E 
register, and the I/O data is transferred via the A register. 

Omitting all parameters will display the current supervisor call 
settings. 

Spacing; A space is required between break and switch. No 
spaces are permitted before break. 


2-96 ZAX Corporation 


ICD-278 for Z80 


Section 2 


MASTER COMMAND GUIDE 


Command Example 


PC MC OP 
010A 7F LD A,A 
< Break User> 


SUPERVISOR 


Execute this sequence: 

>A 100 <- STARTS ASSEMBLING THE SAMPLE PROGRAM 

FROM ADDRESS 100 

0100 LD HL,120H 
0103 LD E,2 

0105 LD A,(HL) 

0106 INC HL 

0107 OR A 

0108 JR NZ,-3 
01 OA LD A, A 

01 OB A <cr> HERE TERMINATES THE INPUT 

> 

> B S = E N <- ENABLES ALL SOFTWARE BREAKPOINTS 

>B/C OF 106 •<- SETS HARDWARE BREAKPOINT C 

>SU/C ON <- USES BREAKPOINT CAS A SUPERVISOR CALL 

>F 120, 139, This is a SUPERVISOR call' message 
>F 13A,143,'nnessage,'0D,0A,00 message 

> G 100 RUNS PROGRAM FROM ADDRESS 100 

This Is a SUPERVISOR call message «- display shows message 

THEN STOPS AT USER 
BREAKPOINT 


SP AF BC DE HL IX lY I IF (SP) 

0000 0044 0000 0012 0144 0000 0000 00 0 OFFB 
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1 Supervisor Function Code Key for ICD-278 for Z80 

Port Input Status Fetch 

Entry Conditions: 
Register E = OlH 
Registers = IIH 

Get input status from TERMINAL Port 

Get input status from HOST/AUX Port 


Exit Conditions: 
Register E 

Register A = OOH 
Register A = FFH 

Unchanged 

No data is available at specified Port 

Data has been received at specified Port 

Input Character from Port 

Entry Conditions: 
Registers = OOH 
Registers = lOH 

Input character from TERMINAL Port 

Input character from HOST/AUX Port 


Exit Conditions: 
Register E 

Register A = 

Unchanged 

Character received from specified Port 


Note: If no character is available at the specified port, control 
will not return from the supervisor call until a character has 
been received. 

Port Output Status Fetch 

Entry Conditions: 
Register E = OSH 
Register E = 13H 

Get output status from TERMINAL Port 

Get output status from HOST/AUX Port 


Exit Conditions: 
Register E 

Register A = OOH 
Register A = FFH 

Unchanged 

Port transmit buffer is busy (not ready) 

Port transmit buffer is empty (ready) 
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Output Character to Port Entry Conditions: 

Register E = 02H 
Register E = 12H 
Register A = 

Exit Conditions: 
Register E 
Register A 


Output character to TERMINAL Port 
Output character to HOST/AUX Port 
Character to be output to specified Port 


Unchanged 

Unchanged 


Note: If transmit buffer is busy when this call is made, control 
will not be returned until buffer is ready and character has 
been sent. 



FUNCTION 

CODE 

DATA OUT DATA IN 

FUNCTION 

E-reg 

A-reg 

TERMINAL Port data in 

00 

- RECEIVE DATA 

TERMINAL Port Input status read 

01 

— Input status 

HOST/AUX Port input status read 

1 1 

— Input status 

TERMINAL Port data out 

02 

Output Data — 

HOST/AUX Port data out 

1 2 

Output data — 

TERMINAL Port output status read 

03 

— Output status 

HOST/AUX Port output status read 

1 3 

— Output status 
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Command TRACE: Status 

Operation Displays the current trace setting. 

Syntax T 

Command Example Execute the following: 

> T <- DISPLAYS THE CURRENT TRACE 

Trace is Clear <- shows iNAaivE trace 

>T A <- SETS TRACE TO AU display 

> T <- DISP AYS NEW TRACE SETTING 

(ON] ALLOOOO-FFFF shows all specification 

> T J SETS TRACE TO JUMP ONLY DISP AY 

> T <- DISP AYS NEW TRACE SETTING 

(ON) JUMP 0000-FFFF <- SHOWS JUMP SPECIFICATION 
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Command 

Operation 


Syntax 

Terms 


TRACE; Qualification 


TRACE 


Enables, disables, or clears the trace setting. 

Applications Note: This command can be used to temporarily 
disable the software trace feature without affecting its location 
within the program or its parameter specifications. 


T switch 


switch = ON, OFF, or CLR 


Syntax Example T ON 

Notes If ON is specified, the trace specification becomes valid. If OFF 

is specified, the trace specification is disabled. If CLR is 
specified, the trace specification becomes cleared. 


Spacing: A space is required between T and switch. 

Command Example See the Syntax Example above, and the "TRACE: Specifica- 
tion" command. 
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TRACE 


Command 

TRACE: Specification 

Operation 

Performs a software trace of the program in non-real time. 


Applications Note: This command allows a section of the user 
program to be displayed in a step-by-step manner by either 
automatically scrolling through the program, or moving 
through the program one line at a time. 

Syntax 

T[/S] mode[,beg_jacldr][,end_adclr] 

Terms 

S = Single step mode. 


mode = A or J 


beg_^addr = Beginning address of memory to trace 
(default = 0). 


end_addr = Ending address of memory to trace 
(default = FFFF). 

Syntax Example 

T/S J,1 00,300 

T A,200,FFF 

Notes 

S causes a single instruction to be executed each time the 
"space bar" is pressed. The mode must be defined as either 

A or J. A means that all commands are traced and displayed, 
and J means all instructions are traced, but only Jump (JP & JR) 
instructions are displayed. 


If beg addr is omitted, the trace starts from address 0. If 

end_addr is omitted, the trace ends at address FFFF. When 

beg addr or end^addr is specified, all the instructions are 

traced, but only the instructions within the specified address 
range are displayed. The instructions that are located outside 
of the address parameters are executed in non-real time as 
well. 


Spacing: A space is required between T and mode (or T/S and 
mode). No spaces are permitted where commas act as 
separators. 
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Command Example Execute this sequence; 


TRACE 


>A 1000 
1000 LD BCO 

1003 XOR A 

1004 ADD A,C 

1005 LD CA 

1006 INC B 

1007 LD A,B 

1008 CP 10H 
100A JP NZ, 1004H 
100D LD AC 
100E LD (1020H),A 


• SHARTS ASSEMBLING PROGRAM AT ADDR 1000 


SIMPLE PROGRAM THAT 
FINDS THE SUMATION 
OF 0+1+2+3+ . . . +n, 
WHERE N = OFH. THE 
RESULT (76H) CAN BE 
FOUND IN MEMORY 
LOCATION 1020H. 


1011 


- <CR> HERE TO TERMINATE ENTRY 


> 

> Dl 1 000 <- DISPLAYS THE PROGRAM JUST ENTERED 

>T A 1000,1100 TRACES ALL INSTRUCTIONS FROM ADDRESS 1000 

TO ADDRESS 1100 


>G 1000 ♦- STARTS THE PROGRAM FROM ADDRESS 1000 AND 

ONE LINE AT A TIME 


> G 1 000 <- STARTS PROGRAM AND DISPLAYS ONE LINE AT A TIME; 

PRESS SPACE BAR TO SCROLL; PRESS Esc TO EXIT 


> T J <- DISPLAYS ONLY JUMP (JP) INSTRUCTIONS 

> G 1 000 <- STARTS PROGRAM AND DISPLAYS ONLY JUMP INSTRUCTIONS; 

PRESS SPACE BAR TO SCROLL PRESS Esc TO EXIT 

>T CLR <- CLEARS THE TRACE FEATURE 


This example is illustrated by first entering a simple program 
so that a trace can be performed on the program. After the 
program is entered, it is disassembled for inspection, and then 
the trace parameters are specified. This example shows that a 
trace is made of all the instruction lines from address 1000 to 
address 1100. The program is then run from address 1000 , 
and the trace is displayed. The next command shows how the 
Jump (JP) instruction command is specified. Finally, the trace 
feature is cleared from the ICD memory. 
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Command 

Operation 


Syntax 

Notes 

Syntax Example 


USER 

Allows a single console terminal to communicate with either 
the ICD or a host computer. 

Applications Note: This command enables the ICD to assume 
a "transparent" condition when it is positioned between a con- 
sole terminal and a host computer, when the system is oper- 
ating in the LOCAL (terminal control of the ICD) mode. In this 
mode, a console terminal (connected to the ICD's TERMINAL 
port) can communicate directly with a host computer (con- 
nected to the ICD’s HOST/AUX port). Essentially, the 
transparent mode uses the ICD as an interface or conduit 
between the two ports. 

U code 


terminate the transparent communication mode. Control 
returns to the ICD command mode when this character is 
entered from the terminal's keyboard. 


The Terminal-to-ICD baud rate should be at least double that 
of the ICD-to-Host baud rate. 


Spacing: A space is required between U and code. 

U ! 

U - 


2-104 ZAX Corporation 


ICD-278forZ80 


Section 2 

MASTER COMMAND GUIDE 

Command 

LOAD 

LOAD 

Operation 

Downloads an Intel Hex file from the host computer to the 
ICD’s memory (or through the ICD to user memory). 


Applications Note: This command can be used in both LOCAL 
(ICD controlled by a terminal and using a computer for stor- 
age) and REMOTE (ICD controlled by a host computer run- 
ning ZICE software) modes. 

Syntax 

l[lsource] filenamel,blas][, message] 

Terms 

source = T, R A, or H 


filename = Name of the file to download to the ICD. 


bias = Memory address offset to be added to the object file 
being loaded (default is 0). 


message = Any ASCII message (in 'single' quotes) or hex 
data, or any combination separated by commas. 

Syntax Example 

L/H TESIABaiOO 

L/A ,,'TYPE TEST.HEX',OD 

L/A 

Notes 

If source is omitted, command defaults to H in the REMOTE 
mode, or LOCAL with HOST ON mode, and T in the LOCAL 
mode. 


T specifies to use the TERMINAL port and X-ON/X-OFF pro- 
tocol. P specifies to use the TERMINAL port and software pro- 
tocol. A specifies to use the HOST/AUX port and X-ON/X-OFF 
protocol. H specifies to use the HOST/AUX port and software 
protocol. (See software specifications in Section 4 for a descrip- 
tion of the software protocol.) 


The message is sent out the source port at the beginning of the 
load operation to provide a way of prompting the host com- 
puter to begin transmitting a file. 
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LOAD 


Command Example 


When using XON-XOFF protocol options (/T, /A), it is necessary 
for the host to either recognize XON-XOFF, or delays must be 
inserted after each carriage return (end of each record). 
Otherwise, every second record may be lost. Also, if recogni- 
tion of XOFF by the host computer is slow (more than two 
characters), this problem could exist as well. In certain in- 
stances, a slower baud rate may help to correct the problem 
(but is usually undesirable, due to extended download times, 
especially with long files). 

Spacing: A space is required before filename] no spaces are 
permitted where commas act as separators. 

See Syntax Example above. The first example shows how the- 
LOAD command is used with ZICE (host software utilizing soft- 
ware protocol). If ZICE is used, /H becomes the default, and 
may therefore be omitted. With this example, a bias of lOOH is 
added to the load address. 

The second example loads a file from a host computer not 
using ZICE software. For this application, the ICD’s HOST/ 
AUX port must be connected to a port on the host computer 
normally designated for a terminal (one having access to the 
OS command language). 

The message is sent to the host computer, followed by a car- 
riage return (specified by OD— which is its ASCII code) prompt- 
ing the host computer to transmit the file TEST.HEX to the ICD. 

The third example is used when the host computer’s OS com- 
mand language cannot be accessed via the SIO port, but 
rather from a separate terminal. This command will be given 
to the ICD first, then the ICD will wait— ready to receive input 
prompted from the host terminal. 
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SAVE 

SAVE 

Operation 

Saves an Intel Hex file from the ICD memory to the host com- 
puter. (The file format is the same as the LOAD command.) 

Syntax 

S[ldestlnation] filename, beg_addr,end_adcl,entry_acldr 
[, message] 

Terms 

destination = J, R A, or H. 


filename = Name of the file to be used for saving the memory 
contents. 


beg addr = First address to save. 


end_jaddr = Last address to save. 


entry ^addr = Starting address of the user program. 


message = Any ASCII message (in 'single' quotes) or hex 
data, or any combination separated by commas. 

Syntax Example 

SA/H TEST.HEmSFRO 

SA/A TEXT.HEX,0,1 FFBO/CREATE TEXT.HEX ',0D 

Notes 

If destination is omitted, command defaults to FI in the 
REMOTE (host computer control of the ICD) mode, or LOCAL 
with HOST ON (host computer assisted) mode, and T in the 
LOCAL (terminal control of the ICD) mode. 


T specifies to use the TERMINAL port and X-ON/X-OFF proto- 
col. P specifies to use the TERMINAL port and software proto- 
col. A specifies to use the HOST/AUX port and X-ON/X-OFF 
protocol. FI specifies to use the HOST/AUX port and software 
protocol. (See software specifications in Section 4 for a de- 
scription of the software protocol.) 

ICD-278 for Z80 

ZAX Corporation 2-107 



MASTER COMMAND GUIDE 


Section 2 


SAVE 


Command Example 


The message will be sent out the destination port at the begin- 
ning of the save operation to provide a way of prompting the 
host computer to receive a file. (Remember to use the USER 
command to access the host and to terminate the file input.) 

Either XOFF-XON or DTR-DSR flow control will be accepted by 
the ICD when the destination option is /T or /A. If the host com- 
puter does not provide input flow-control, its input buffer will 
probably overflow. 

Spacing: A space is required before destination] no spaces 
are permitted where commas act as separators. 

See Syntax Example. 
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Command 

VERIFY 

VERIFY 

Operation 

Compares an Intel Hex format file on the host computer to the 

ICD memory (or through the ICD to the user memory). 


NOTE: All parameters and uses are identical to the LOAD com- 
mand, with the exception that the VERIFY command does not 
alter memory, it only compares the memory contents against 
the file and displays the difference. 

Syntax 

y[lsource]f\lename[,bias][, message] 

Terms 

source = T, R A, or H. 


filename = Name of the file to download to the ICD. 


bias = Memory address offset to be added to the object file 
being compared (default is 0). 


message = Any ASCII message (in 'single' quotes) or hex 
data, or any combination separated by commas. 

Syntax Example 

V/H TEST.HEXIOO 

Notes 

T specifies to use the TERMINAL port and X-ON/X-OFF proto- 
col. P specifies to use the TERMINAL port and sofware proto- 
col. A specifies to use the HOST/AUX port and X-ON/X-OFF 
protocol. H specifies to use the HOST/AUX port and software 
protocol. (See software specifications in Section 4 for a de- 
scription of the software protocol.) 


The message is sent out the source port at the beginning of the 
load operation to provide a way of prompting the host com- 
puter to begin transmitting a file. 
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Command Example 


If source is omitted, command defaults to H in the REMOTE 
(host computer controlled) mode and T in the LOCAL (terminal 
controlled) mode. 

See the LOAD command Notes for additional information. 

Spacing: A space is required before filename-, no spaces are 
permitted where commas act as separators. 

See Syntax Example, and the LOAD command examples for 
additional information. 
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HOST 

-available with ZICE software only 

ZICE Command 

HOST 

Operation 

Initiates or terminates LOCAL "Host Computer Assisted” 
mode. 


Applications Note: This command enables the ICD to operate 
as though it is in the REMOTE mode, when connected to a host 
computer running ZICE. Using this configuration, only one SIO 
port is required of a multi-user host computer (e.g., VAX), 
rather than two ports as required in the REMOTE mode. 

Syntax 

HOST switch 

Terms 

switch = ON or OFF 

Syntax Example 

HOST ON 

Notes 

This command is only available with firmware version 2.0 or 
greater, and only recognized when the ICD is in the LOCAL 
mode. 


ON enables the HOST feature and OFF disables the HOST 
feature. 


The QUIT command will also perform the equivalent of the 
HOST OFF command, but the HOST OFF command does not 
terminate ZICE. 


Spacing: A space is required between HOST and switch. 

Command Example 

See Syntax Example above. 
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ZICE Command QUIT 

Operation Exits ZICE software control and returns control to the host com- 
puter system, or to the ICD if used in the LOCAL "Host Com- 
puter Assisted” mode (see the HOST command). 

Syntax Q 
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Command Syntax 


Summary 


ASSEMBLE 

A mem addr<cr> 

xxxx (Z80 assembly code) < cr > 
xxxx <cr> 

BREAK 

B [INI] 

B[/name] switch 

B[/name] status, addr[,passcount] 

B[/namei addr[,passcount] 

B S= switch 

B S=op code 

B/X edge[,passcount] 

B/X switch 

B/E switch 

BAA/ switch 

B/T switch 

COMPARE 

CO beg_addr,end_addrcomp_addr[direction] 

DISASSEMBLE 

Dl [beg addr] [,end addr] 

DUMP 

D[/W] beg addr[,end addr] 

EVENT 

EV [switch] 

EV [ST=status] [,A=addr] [,D=data] 

EXAMINE 

E[/W] [/N] beg_addr[=mod_data] 

FILL 

F[/W] [/N] beg_addrend_addrdata 

GO 

G [beg_addr] [,end_addr] [and_addr’*‘2] 

HISTORY 

H [CLR] 

H mode[,int point] [,term point] 

H mode[,range] 

H S,/[addr]/[data]/[cyclel [,int point] [.term point] 

IDENTIFICATION 

ID 
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IN-CIRCUIT 

1 [mode] 

MAP 

MA [beg addr[Bnd addr]=area] 

MOVE 

M beg_addrend_addr,mov_addr[dlrectlon] 

NEXT 

N [steps] 

OFFSET 

O [&number=addr] 

PIN 

PI [signal =swltch] 

PORT 

P port addr[=mod data] 

PRINT 

PR switch 

REGISTER 

R [RESET] 

R reg name[=data] 

SEARCH 

S[IW\ [/D] beg_addr^nd_addr^earch_data 

SUPERVISOR 

SU[/break switch] 

TRACE 

T [switch] 

T[/S] mode[,beg addr] [^nd — addr] 

USER 

U code 

LOAD 

L[/source] filename[,bias] [.message] 

SAVE 

S[/destination] filename,beg_addrand_add.entry_addr 
[.message] 

VERIFY 

V[/source] filename[.bias] [.message] 

HOST 

H switch 

QUIT 

Q 


NOTE: Items in brackets ([ ]; are optional. 
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Special Environments 


In this section you’ll learn about the five internal control mod- 
ules which, with the power supply, make up your ICD. These 
modules are used to control the various processes that are re- 
quired for emulation, including such things as electronically 
substituting your target system’s microprocessor with the ICD’s 
own processor, controlling communication betweeen the ICD 
and host computer or terminal, and tracing (and storing) a por- 
tion of the program memory contents for analysis. 

Although it is not necessary to read this section to use your 
ICD, you may find the information in this section helpful if you 
require an examination of how the ICD operates under certain 
conditions and in particular environments. In certain instances, 
some modules may need to be modified to permit the ICD to 
operate at peak performance with some systems. All possible 
modifications are detailed in each module description. 

In order to modify the components and controls, or to change 
certain settings on the modules, the ICD must be partially or 
fully disassembled. At the end of this section is a procedure 
which shows you how to disassemble your ICD and remove 
(and replace) the five control modules. 

the ICD which are permitted under the Warranty Policy. In 
order to preserve the warranty on this equipment, do not ad- 
just, modify, and/or in any way alter the controls or compo- 
nents on the modules which are not marked by this symbol. 
(See page 3-37 for a complete description on this subject.) 
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What Are The Ftve 
Control Modules? 

Indlcator/Control Module 


Serial Interface Output 
Module 


Real-time Itace Module 


CPU Control Module 


Emulation Memory (Unit) 
Module 


This module contains the Operator Panel switches and indi- 
cator lamps, All controls are externally accessible. [There are 
no user-serviceable controls on this module.] 

This module contains the RS-232 serial interface connectors for 
the TERMINAL and HOST/AUX ports. A 20mA current loop 
or TTL level terminal may also be used by changing the con- 
figuration of this module. [There are several user-serviceable 
controls, components, and switches on this module— see "How 
To Disassemble Your ICD,” located at the end of this section, 
after reading about the module’s components.] 

This module allows tracing of the program memory contents 
and storage of the captured data in the real-time trace buffer. 
[There are no user-serviceable controls on this module.] 

This module contains the connectors, circuitry, and Z80 micro- 
processor, jyhidpallaw.tJie .ICD laemulate.JhB Jarcrpt avstem's 
this module— see “How To Disassemble Your ICD,” located at 
the end of this section, after reading about the module's com- 
ponents.] 

This module contains 64K bytes of high-speed static RAM 
(known as “emulation memory”) which can be used for down- 
loading files, altering the memory contents, and loading future 
memory into the target system. [There are no user-serviceable 
components on this module.] 
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Module 


Description 

The Indicator/Control module (S-730) contains three switches, 
four indicator lamps, one 60-pin connector, and intermediary 
circuitry. Switch SWl selects between the internal (INT) or 
external (EXT) clock. Switches SW2 and SW3 activate the 
RESET and MONITOR functions, respectively. The indicator 
lamps Dl, D2, D3, and D4 show the condition of the HALT, 
MONITOR, ICE (in-circuit enable), and POWER functions. 


The three switches and four indicator lamps are all accessible 
for operation (and viewing) from the outside of the ICD, so 
there are no user-serviceable controls or components on this 
module. 
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Serial Interface Output 
Module 


Description The Serial Interface Output (SIO) module (S-791) controls the 
communication between the ICD and various external devices 
(host computer, terminal, or printer) through the TERMINAL 
and HOST/AUX ports. The SIO module's internal components 
feature jumper sockets and line drivers that can be modified 
to permit either RS-232, current loop, or TTL interface opera- 
tion, There are also two transmission format switches (DSW3 
and DSW4) which are used to set the data format and stop bits 
for the TERMINAL and HOST/AUX ports, and a special socket 
which allows any key on the console keyboard to activate the 
MONITOR break switch in the ICD. 

These components are all user-serviceable, which means the 
ICD must be disassembled before they can be adjusted or 
modified (see "How To Disassemble Your ICD" located at the 
end of this section). 

The module's remaining components are all externally acces- 
sible. These include the DCE/DTE and LOCAL/REMOTE 
switches, the TERMINAL and HOST/AUX port connectors, and 
two rotary switches which set the communication baud rates 
for the ports. 


Baud Rate The Baud Rate switches are used to set the baud rates for the 
Switches TERMINAL and HOST/AUX ports. The factory setting is *1 
(9600 bps) for both ports. There are 13 other baud rate settings 
available; do not set the baud rate switches to E or F. 


Changing The 
Baud Rote Settings 

TERMINAL HOST/AUX 



The Baud Rate switches are rotary-type switches. To change 
the baud rates, turn the dials to the number or letter shovra in 
the Baud Rate diagram below. Use a pointed object such as a 
pen tip or a small screwdriver. 


Baud Rate Switch No. 

0 

D 

D 
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El 
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a 

a 

o 
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